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PREFACE 


Ihe SQL*Plus User's Guide and Reference introduces the SQL*Plus 
program and its uses. It also provides a detailed description of 
each SQL*Plus command. 


This manual addresses business and technical professionals who have a 
basic understanding of the SQL database language. If you do not have 
any familiarity with this database tool, you should refer to the SQL 
Language User's Guide and the SQL Language Reference Manual. If you 
plan to use the PL/SQL database language in conjunction with 
SQL*Plus, refer to the PL/SQL User's Guide and Reference for information 
on using PL/SQL. 
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How to Use this 


Refer to the following tables for a list of topics covered by this manual, 





Manual a description of each topic, and the number of the chapter that covers 
the topic. 
PARTI Topic Description Chapter Number 
Understanding SQL*Plus 
Introduction Gives an overview of SQL*Plus, 1 
instructions on using this Guide, 
and information on what you need 
to run SQL*Plus. 
Learning Explains how to start SQL*Plus 2 
SQL*Plus Basics and enter and execute commands. 
You learn by following 
step-by-step examples using 
sample tables. 
Manipulating Also through examples, helps you 3 
Commands learn to edit commands, save them 
for later use, and write interactive 
commands. 
Formatting Query Explains how you can format 4 
Results columns, clarify your report with 
spacing and summary lines, define 
page dimensions and titles, and 
store and print query results. Also 
uses step-by-step examples. 
Accessing Tells you how to connect to 5 
Databases default and remote databases, and 
how to copy data between 
databases and between tables on 
the same database. Includes one 
example. 
PARTII Topic Description Chapter Number 
Reference 
Command Gives you a SQL*Plus command 6 
Reference summary and detailed 
descriptions of each SQL*Plus 
command in alphabetical order. 
COPY Command Lists copy command error Appendix A 
Error Messages messages, their causes, and 
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appropriate actions for error 
recovery. 


Related Publications 








Topic Description Chapter Number 
Version 3.0 Describes enhancements to Appendix B 
Enhancements SQL*Plus in Version 3.0. 
SQL*Plus Limits Lists the maximum values for Appendix C 
elements of SQL*Plus. 
SQL Command Provides a list of major SQL Appendix D 
List commands and clauses. 
Restricting Users’ Explains how to restrict users’ Appendix E 
Privileges in access to certain SQL*Plus and 
SQL*Plus SQL commands. 
SQL*Plus Provides information on SQL*Plus Appendix F 
Commands from commands from earlier versions. 
Earlier Versions 
Definitions of Defines technical terms associated Glossary 
Terms with the ORACLE RDBMS and 
SQL*Plus, 


Related documentation includes: 
» SQL Language Reference Manual, Part No. 778 
o SQL Language User's Guide, Part No. 5070 
« PL/SQL User's Guide and Reference, Part No. 800 


+ Oracle installation and user’s manual(s) provided for your 
operating system (part numbers vary) 


ORACLE Relational Database Management System documentation 


includes: 


e ORACLE Database Administrator's Guide, Part No. 3601 
* ORACLE Utilities User's Guide, Part No. 3602 


* ORACLE Error Messages and Codes, Part No. 3605 


SQL*Graph documentation includes the SQL*Graph User's Guide, 


Part No. 3402 
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Your Comments Are Oracle Corporation values and appreciates your comments as an 

Welcome ORACLE user and reader of the manuals. As we write, revise, and 
evaluate, your opinions are the most important input we receive. At 
the back of this manual is a Reader’s Comment Form that we 
encourage you to use to tell us both what you like and what you dislike 
about this (or other) ORACLE manuals. If the form is gone, or if you 
would like to contact us, please use the following address, or call us at 
(415) 598-8000. 


SQL*Plus Product Manager 
Oracle Corporation 

20 Davis Drive 

Belmont, CA 94002 


iv SQL*Plus User’s Guide and Reference 


PART I 


Chapter 1 


Chapter 2 


CONTENTS 


UNDERSTANDING SQL*PLUS 


Introduction 


Overview of SQL*Plus 
Basic Concepts 
Who Can Use SQL*Plus 


Other Ways of Working with the ORACLE RDBMS 


Using this Guide 
Conventions for Command Syntax 
Sample Tables 


What You Need to Run SQL*Plus 
Hardware and Software 
Information Specific to Your Operating Syekkin 
Username and Password 
Access to Sample Tables 


Learning SQL*Plus Basics . . . 


Getting Started 
Using the Keyboard 
Starting SQL*Plus 
Leaving SQL*Plus 


Contents 


Chapter 3 


Entering and Executing Commands 


Running SQL Commands 

Running PL/SQL Blocks 

Running SQL*Plus Commands 

Variables that Affect Running Commands 


Saving Changes to the Database Automatically 


Stopping a Command while It Is Running 


Collecting Timing Statistics on Commands You Run 
Running Host Operating System Commands 


Running SQL*Forms Forms 


Getting Help 


Listing a Table Definition 
Controlling the Display 
Interpreting Error Messages 


Manipulating Commands 


Editing Commands 


Listing the Buffer Contents 

Editing the Current Line 

Adding a New Line 

Appending Text to a Line 

Deleting a Line 

Editing Commands with a System Editor 


Saving Commands for Later Use 


Storing Commands in Command Files 
Placing Comments in Command Files 
Retrieving Command Files 

Running Command Files 

Nesting Command Files 

Modifying Command Files 


Exiting from a Command File with a Return Code 


Setting Up Your SQL*Plus Environment 


vi SQL*Plus User’s Guide and Reference 





Writing Interactive Commands 
Defining User Variables 
Using Substitution Variables 
Passing Parameters through the START amie. 
Communicating with the User 


Chapter 4 Formatting Query Results 


Formatting Columns 
Changing Column Headings 
Formatting NUMBER Columns . 
Formatting CHAR, LONG, and DATE Columns 
Copying Column Display Attributes 
Listing and Resetting Column Display Attributes 
Suppressing and Restoring Column Display Attributes 
Printing a Line of Characters after er Wrapped 
Column Values 

Clarifying Your Report with Spacing and Summary Lines 
Suppressing Duplicate Values in Break Columns 
Inserting Space when a Break Column’s Value Changes 
Inserting Space after Every Row 
Using Multiple Spacing Techniques 
Listing and Removing Break Definitions 


Computing Summary Lines when a Break Golan s 
Value Changes 


Computing Summary Lines at t the End of the Report 
Computing Multiple Summary Values and Lines 
Listing and Removing COMPUTE Definitions 


Defining Page Titles and Dimensions 
Setting the Top and Bottom Titles 


Displaying the Page Number and other 
System-Maintained Values in Titles 


Listing, Suppressing, ; and Restoring Page Title 
Definitions 


Displaying Column Valuesi in Titles 
Displaying the Current Date in Titles 
Setting Page Dimensions 


» 4-23 
. 4-23 
. 4-25 
+ 4-25 


Contents 


vii 





Chapter 5 


PART II 
Chapter 6 
Appendix A 
Appendix B 
Appendix C 
Appendix D 
Appendix E 


Appendix F 


Storing and Printing Query Results 
Sending Results to a File 
Sending Results to a Printer 


Accessing Databases 
Connecting to the Default Database 


Connecting to a Remote Database 
Connecting to a Remote Database from within ‘SOL*Plus 
Connecting to a Remote Database as You Start SQL*Plus 


Copying Data from One Database to another 
Understanding COPY Command Syntax 
Controlling Treatment of the Destination Table 
Interpreting the Messages that COPY Displays 
Specifying another User’s Table 


Copying Data between Tables on One Database 
REFERENCE 

Command Reference 

COPY Command Error Messages 

Version 3.0 Enhancements E AE fle rex se Sed. te 
SQL*Plus Limits So “bdr wt wcee We bee E E AE 
SQL Command List ae ter te, E OR O 
Restricting Users’ Privileges in SQL*Plus . . . 
SQL"Plus Commands from Earlier Versions 

Glossary 


Index 


viii SQL*Plus User's Guide and Reference 


4-28 


. 4-28 
. 4-28 


5-1 
5-2 


5-2 
5-3 
5-3 
5-4 
5-4 
5-5 
5-7 
5-7 


5-8 


I-1 


E-1 


F-1 


UNDERSTANDING 
SQOL*PLUS 


CHAPTER 


INTRODUCTION 


This chapter introduces you to SQL*Plus, covering the following topics: 


overview of the SQL*Plus program 
definition of basic concepts 
explanation of who can use SQL*Plus 


description of other programs you can use with the 
ORACLE RDBMS 


command syntax conventions used in this Guide 
sample tables you will use 


equipment, software, and information you need to run 
SQL*Plus 
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Overview of SQL*Plus 


Basic Concepts 


You can use the SQL*Plus (pronounced “sequel plus") program in 
conjunction with the SQL database language and its procedural 
language extension, PL/SQL. The SQL database language allows you 
to store and retrieve data in the Oracle Corporation relational database 
management system, the ORACLE RDBMS. PL/SQL allows you to 
link several SQL commands through procedural logic. 


SQL*Plus enables you to manipulate SQL commands and PL/SQL 
blocks, and to perform many additional tasks as well. Through 
SQL*Plus, you can: 


« enter, edit, store, retrieve, and run SQL commands and 
PL/SQL blocks 


+ format, perform calculations on, store, and print query results 
in the form of reports 


+ list column definitions for any table 
* access and copy data between SQL databases 
* send messages to and accept responses from an end user 


The following definitions explain concepts central to SQL*Plus: 


command An instruction you give SQL*Plus or the ORACLE 
RDBMS. 

block A group of SQL and PL/SQL commands related to 
one another through procedural logic. 

table The basic unit of storage in the ORACLE RDBMS. 

query A SQL command (specifically a SQL SELECT 
command) that retrieves information from one or 
more tables. 

query results The data retrieved by a query. 

report Query results formatted by you through SQL*Plus 
commands. 
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Who Can Use SQL*Plus The SQL*Plus, SQL, and PL/SQL command languages are powerful 


Other Ways of 
Working with the 
ORACLE RDBMS 


enough to serve the needs of users with some database experience, yet 
straightforward enough for new users who are just learning to work 
with the ORACLE RDBMS. 


The design of the SQL*Plus command language makes it easy to use. 
For example, to give a column labelled ENAME in the database the 
clearer heading "Employee", you might enter the following command: 


COLUMN ENAME HEADING EMPLOYEE 
Similarly, to list the column definitions for a table called EMP, you 
might enter this command: 


DESCRIBE EMP 


Oracle Corporation offers many programs through which you can 
work with the ORACLE RDBMS, including the following products: 


SQL*ReportWriter Allows application developers to develop a wide 
variety of production-quality reports. 


SQL*Forms Gives developers a forms-based tool for creating, 
maintaining, and running applications. 


ORACLE for 1-2-3 Gives Lotus 1-2-3 users access to data in the 
ORACLE RDBMS. 


SQL? QMX Gives you an IBM QMF compatible interface to 
ORACLE, providing query-by-example capability 
along with the ability to enter SQL commands 
interactively. 

Easy*SQL Provides an ad-hoc interface to ORACLE that does 
not require knowledge of SQL, but uses a system 
of menus, panels, and boxes instead. Easy*SQL 
offers graphics capability, ad-hoc querying, simple 
reporting, and simple data entry. 


SQL*Graph Allows you to report data in a graphic format. 
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Using this Guide 


Conventions for 
Command Syntax 


TABLE 1-1 
Commands, Terms, and Clauses 


This Guide gives you information on SQL*Plus that applies to all 
operating systems. Some aspects of SQL*Plus, however, differ on each 
operating system. Such operating-system-specific details are covered 
in the Oracle installation and user’s manual(s) provided for your 
system. Use these operating-system-specific manuals in conjunction 
with the SQL*Plus User's Guide and Reference. 


Throughout this Guide, examples showing how to enter commands use 
a common command syntax and a common set of sample tables. Both 
are described below. You will find the conventions for command 
syntax particularly useful when referring to the reference portion of 
this Guide. 


The following two tables describe the notation and conventions for 
command syntax used in this manual. 





Feature Example Explanation 
uppercase BIITLE Enter text exactly as spelled; it 
need not be in uppercase. 
lowercase, italics column A clause value; substitute an 
appropriate value. 
words with 
specific meanings c A single character. 
char A CHAR value—a literal in single 
quotes—or an expression with a 
CHAR value. 
dore A date or an expression with a 
DATE value. 
expr An unspecified expression. 
moran A number or an expression with 
a NUMBER value. 
text ACHAR constant with or without 
single quotes. 
variable A user variable (unless the text 


specifies another variable type). 


Other words are explained where used if their meaning is not 
explained by context. 
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TABLE 1-2 
Punctuation 


Sample Tables 


Feature Example Explanation 





vertical bar ] Separates alternative syntax 
elements that may be optional or 
mandatory. 

brackets [OFF [ON] One or more optional items. If 


two items appear separated by |, 
enter one of the items separated by 
1. Do not enter the brackets or |. 


braces {OFF |ON} A choice of mandatory items; 
enter one of the items separated by 
|. Do not enter the braces or |. 


underlining {QEE | ON} A default value; if you enter 
nothing, SQL*Plus assumes this 
value. 

three periods aehiicis Preceding item(s) may be 


repeated any number of times. 


Enter other punctuation marks (such as parentheses) where shown in 
the command syntax. 


Many of the concepts and operations in this Guide are illustrated by a 
set of sample tables. These tables contain personnel records for a 
fictitious company. As you complete the exercises in this Guide, 
imagine that you are personnel director for this company. 


The exercises make use of the information in two sample tables: 


EMP Contains information about the employees of the 
sample company. 

DEPT Contains information about the departments in the 
company. 


Figures 1-1 and 1-2, on the following page, show the information in 
these tables. 
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FIGURE 1-1 EMPNO ENAME JOB MGR HIREDATE SAL COMM DEPTNO 
EMP Table; 0 tke twee ht Se Pa ost ee eee eee Ae A a 


7369 SMITH CLERK 7902 17-DEC-80 800 20 
7499 ALLEN SALESMAN 7698 20-FEB-81 1600 300 30 
7521 WARD SALESMAN 7698 22-FEB-81 1250 500 30 
7566 JONES MANAGER 7839 02-APR-81 2975 20 
7654 MARTIN SALESMAN 7698 28-SEP-81 1250 1400 30 
7698 BLAKE MANAGER 7839 01-MAY-81 2850 30 
7782 CLARK MANAGER 7839 09-JUN-81 2450 10 
7788 SCOTT ANALYST 7566 09-DEC-82 3000 20 
7839 KING PRESIDENT 17-NOV-81 5000 10 
7844 TURNER SALESMAN 7698 08-SEP-81 1500 0 30 
7876 ADAMS CLERK 7788 12-JAN-83 1100 20 
7900 JAMES CLERK 7698 03-DEC-81 950 30 
7902 FORD ANALYST 7566 03-DEC-81 3000 20 
7934 MILLER CLERK 7782 23-JAN~82 1300 10 
FIGURE 1-2 DEPTNO DNAME Loc 
DEPT Table? 0 eee, SoSeLKeesee aia 
10 ACCOUNTING NEW YORK 
20 RESEARCH DALLAS 
30 SALES CHICAGO 
40 OPERATIONS BOSTON 
PS SDR soe NIISVS MSDN OCR 


What You Need to Run SQL*Plus 


To run SQL*Plus, you need hardware, software, 
operating-system-specific information, a username and password, and 
access to one or more tables. 


Hardware and Software The computer on which you run ORACLE and SQL*Plus is called your 
host computer. ORACLE and SQL*Plus can run on many different kinds 
of host computers. 


Your host computer's operating system manages the computer’s 
resources and mediates between the computer hardware and programs 
such as SQL*Plus. Different computers use different operating systems. 
For information about your host computer's operating system, see the 
documentation provided with the computer. 


Before you can begin using SQL*Plus, both ORACLE and SQL*Plus 
must be installed on your computer. If you have multiple users on 
your host computer, your organization should have a Database 
Administrator (called a DBA) who supervises the use of the ORACLE 
RDBMS. 
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Information Specific to 
Your Operating System 


Username and 
Password 


Multi-User Systems 


Single-User Systems 


Access to Sample 
Tables 


The DBA is responsible for installing ORACLE and SQL*Plus on your 
system. If you are acting as DBA, see the instructions for installing the 
ORACLE RDBMS and SQL*Plus in the Oracle installation and user’s 
manual(s) provided for your operating system. 


A few aspects of ORACLE and SQL*Plus differ from one type of host 
computer and operating system to another. These topics are discussed 
in the Oracle installation and user’s manual(s), published in a separate 
version for each host computer and operating system that SQL*Plus 
supports. 


Keep a copy of your Oracle installation and user’s manual(s) available 
for reference as you work through this Guide. When necessary, this 
Guide will refer you to your installation and user’s manual(s). 


When you start SQL*Plus, you will need a username that identifies you 
as an authorized ORACLE user, and a password that proves you are the 
legitimate owner of your username. 


If several people share your host computer's operating system, your 
DBA can set up your SQL*Plus username and password. You will also 
need a system username and password to gain admittance to the 
operating system. These may or may not be the same ones you use 
with SOL*Plus. 


If only one person at a time uses your host computer, you may be 
expected to perform the DBA’s functions for yourself. In that case, you 
can use the ORACLE username SCOTT and password TIGER. Or, if 
you want to define your own username and password, see the 
discussion of the SQL GRANT command in the SQL Language Reference 
Manual. 


Each table in the database is "owned" by a particular user. You may 
wish to have your own copies of the sample tables to use as you try the 
examples in this Guide. To get your own copies of the tables, see your 
DBA or run the ORACLE-supplied command file named DEMOBLD 
(you run this file from your operating system, not from SQL*Plus). 


Note: DEMOBLD creates a new SQL*Plus LOGIN file. See the 
subsection "Setting Up Your SQL*Plus Environment" under "Saving 
Commands for Later Use" in Chapter 3 if you already have a LOGIN 
file in your directory and wish to save it. Note that the SQL*Plus 
LOGIN file is not the same as the operating system login file. 


Introduction 1- 








When you have no more use for the sample tables, remove them by 
running another ORACLE-supplied command file named 
DEMODROP. For instructions on how to run DEMOBLD and 
DEMODROP, see the Oracle installation and user’s manual(s) provided 
for your operating system. 
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CHAPTER 


LEARNING 
SOL*PLUS BASICS 


his chapter helps you learn the basics of using SQL*Plus, including 
the following topics: 


using the keyboard 
starting and leaving SQL*Plus 


running SQL commands, PL/SQL blocks, and SQL*Plus 
commands 


understanding variables that affect running commands 
saving changes to the database automatically 

stopping a command while it is running 

collecting timing statistics on commands you run 


running host operating system commands and SQL*Forms 
forms 


listing a table definition 
controlling the display 
interpreting error messages 


Read this chapter while sitting at your computer, and try out the 
examples shown. Before beginning, make sure you have access to the 
sample tables described in Chapter 1. 
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Getting Started 


Using the Keyboard 


TABLE 2-1 
SQL*Plus Special Keys 
and their Functions 


To begin using SQL*Plus, you must first become familiar with the 
functions of several keys on your keyboard, and understand how to 
start and leave SQL*Plus. 


SQL*Plus attaches special significance to several of the keys on your 
keyboard. Table 2-1 lists these keys. 


Since different computer keyboards have different positions and names 
for these keys, this Guide describes the keys by their functions. If the 
keys used by SQL*Plus for each function differ from normal usage, the 
Oracle installation and user’s manual(s) provided for your operating 
system tell which physical key performs each function on the types of 
keyboards most commonly used with your host computer. 


Fill in each blank in Table 2-1 with the name of the corresponding 
keyboard key. Then locate each key on your keyboard. 





SQL*Plus Keyboard 

Key Name Key Name Function 

[Return] End a line of input. 

[Backspace] Move cursor left one character to 
correct an error. 

[Pause] _______—S_ Suspend program operation and 
display of output. 

[Resume] Resume program operation and 
output [Pause]. 

[Cancel] Halt program operation; return to 
the SQL*Plus command prompt. 

[Interrupt] - Exit SQL*Plus and return to the 
host operating system. 
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Starting SOL*Plus 


Example 2-1 
Starting SQL*Plus 


Now that you have identified important keys on your keyboard, you 
are ready to start SQL*Plus. 


This example shows you how to start SOL*Plus. Follow the steps 
shown. 


1. Make sure that the ORACLE RDBMS has been installed on your 
computer. 


2. Turn on your computer (if it is off) and log on to the host operating 
system (if required). If you are already using your computer, you 
need not log off or reset it. Simply exit from the program you are 
using (if any). 


You should see one or more characters at the left side of the 
screen—the operating system’s command prompt, which signals 
that the operating system is ready to accept a command. In this 
Guide the operating system’s prompt will be represented by a 
dollar sign ($). Your computer's operating system prompt may be 
different. 


w 


. Enter the command SQLPLUS and press [Return]. This is an 
operating system command that starts SQL*Plus. 


Note: Some operating systems expect you to enter commands in 
lowercase letters. If your system expects lowercase, enter the 
SQLPLUS command in lowercase. 


$ SQLPLUS 
SQL"Plus displays its version number, the date, and copyright 


information, and prompts you for your username (the text 
displayed on your system may differ slightly): 


SQL*Plus: Version 3.0.3 - Production on Fri Jan 20 09:39:26 
1989 


Copyright (c) Oracle Corporation 1979, 1988. All rights 
reserved. 


Enter user-name: 


4. Enter your username and press [Return]. SQL*Plus displays the 
prompt "Enter password:". 


a 


- Enter your password and press [Return] again. For your protection, 
your password does not appear on the screen. 


The process of entering your username and password is called 
logging on. SQL*Plus displays the version of ORACLE to which 
you connected and the versions of available tools such as PL/SQL. 
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Shortcuts to Starting 
SQL*Plus 


Leaving SQL*Plus 


2-4 


Example 2-2 
Exiting SQL*Plus 


Next, SQL*Plus displays the SQL*Phus command prompt: 
sOL> 


The command prompt indicates that SQL*Plus is ready to accept 
your commands. 


If SQL*Plus does not start, you should see a message meant to help you 
correct the problem. For further information, refer to the ORACLE 
Error Messages and Codes manual for ORACLE RDBMS error messages, 
or to your operating system manual for system error messages. 


When you start SQL*Plus you can enter your username and password, 
separated by a slash (/), following the command SQLPLUS. For 
example, if your username is SCOTT and your password is TIGER, you 
can enter 


$ SQLPLUS SCOTT/TIGER 


and press [Return]. You can also arrange to log on to SQL*Plus 
automatically when you log on to your host operating system. See the 
Oracle installation and user’s manual(s) provided for your operating 
system for details. 


When you are done working with SQL*Plus and wish to return to the 
operating system, enter the EXIT command at the SQL*Plus command 
prompt. 


To leave SQL*Plus, enter the EXIT command at the SQL*Plus command 
prompt: 
SQL> EXIT 


SQL*Plus displays the version of ORACLE you disconnected from and 
the versions of tools available through SQL*Plus. After a moment you 
see the operating system prompt. 


Before continuing with this chapter, follow steps 3, 4, and 5 of Example 
2-1 to start SOL*Plus again. Or, log on using the shortcut shown under 
"Shortcuts to Starting SQL*Plus,” above. 
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Dos SE SEE) 
Entering and Executing Commands 


Your computer's cursor, or pointer (typically an underline, a 
rectangular block, or a slash) appears after the command prompt. The 
cursor indicates the place where the next character you type will 
appear on your screen. 


To tell SQL*Plus what to do, simply type the command you wish to 
enter. Usually, you separate the words in a command from each other 
by a space or tab. You can use additional spaces or tabs between 
words, if you wish, to make your commands more readable. 


Note: You will see examples of spacing and indentation throughout this 
Guide. When you enter the commands in the exercises, you do not have 
to space them as shown, but you may find them clearer to read if you 

do. 


You can enter commands in capitals or lowercase. For the sake of 
clarity, all table names, column names, and commands in this Guide 
appear in capital letters. 


You can enter three kinds of commands at the command prompt: 


« SQL commands, for working with information in the database 


e PL/SQL blocks, also for working with information in the 
database 

+ SQL*Plus commands, for formatting query results, setting 
options, and editing and storing SQL commands and PL/SQL 
blocks 


The manner in which you continue a command on additional lines, end 
a command, or execute a command differs depending on the type of 
command you wish to enter and run. After you enter the command 
and direct SQL*Plus to execute it, SQL*Plus processes the command 
and redisplays the command prompt, indicating that you can enter 
another command. 
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Running SQL The SQL command language enables you to manipulate data in the 
Commands database. See your SQL Language User's Guide and SQL Language 
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Reference Manual for information on individual SQL commands. 


Example 2-3 In this example, you will enter and execute a SQL command to display 
Entering aSQL the employee number, name, job, and salary of each employee in the 
Command sample table EMP. 


1. At the command prompt, enter the first line of the command: 
SQL> SELECT EMPNO, ENAME, JOB, SAL 


If you make a mistake, use [Backspace] to erase it and re-enter. 
When you are done, press [Return] to move to the next line. 


2. SQL*Plus will display a "2", the prompt for the second line. Enter 
the second line of the command: 


2 FROM EMP WHERE SAL < 2500; 


The semicolon(;) means that this is the end of the command. Press 
[Return]. SQL*Plus processes the command and displays the 
results on the screen: 


EMPNO ENAME JOB SAL 
7369 SMITH CLERK 800 
7499 ALLEN SALESMAN 1600 
7521 WARD SALESMAN 1250 
7654 MARTIN SALESMAN 1250 
7782 CLARK MANAGER 2450 
7844 TURNER SALESMAN 1500 
7876 ADAMS CLERK 1100 
7900 JAMES CLERK 950 
7934 MILLER CLERK 1300 


9 records selected 


SQL> 


After displaying the results and the number of records retrieved, 
SQL*Plus displays the command prompt again. If you made a 
mistake and therefore did not get the results shown above, simply 
re-enter the command. 


The headings may be repeated in your output, depending on the 
setting of a system variable called PAGESIZE. Whether you see the 
message concerning the number of records retrieved depends on 
the setting of a system variable called FEEDBACK. You will learn 
more about system variables later in this chapter, in the section 
“Variables that Affect Running Commands." To save space, the 
number of records selected will not be shown in the rest of the 
examples in this manual. 
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Understanding SQL 
Command Syntax 


Just as a spoken language has syntax rules that govern the way 
speakers of the language assemble words into sentences, SQL*Plus has 
syntax rules that govern how you assemble words into commands. 
There are only a few such rules, but you must follow them if you want 
SQL*Plus to accept and properly execute your commands. 


Dividing a SQL Command into Separate Lines You can divide your 
SQL command into separate lines at any points you wish, as long as 
individual words are not split between lines. Thus, you can enter the 
query you entered in Example 2-3 on one line: 


SQL> SELECT EMPNO, ENAME, JOB, SAL FROM EMP WHERE SAL < 2500; 


Or, you can enter the query on several lines: 
SQL> SELECT 
2 EMPNO, ENAME, JOB, SAL 


3 FROM EMP 
4 WHERE SAL < 2500; 


In this Guide, you will find most SQL commands divided into clauses, 
one clause on each line. In Example 2-3, for instance, the SELECT and 
FROM clauses were placed on separate lines. Many users find this 
most convenient, But you may choose whatever line division makes 
your command most readable to you. 


Ending a SQL Command You can end a SQL command in one of 
three ways: 

» witha semicolon (;) 

e witha slash (/) ona line by itself 

e with a blank line 
A semicolon tells SQL*Plus that you want to run the command. Type 
the semicolon at the end of the last line of the command, as shown in 
Example 2-3. After typing the semicolon, press [Return]. SQL*Plus will 
process the command. 
If you mistakenly press [Return] before typing the semicolon, SQL*Plus 


will prompt you with a line number for the next line of your command. 
Type the semicolon and press [Return] again to run the command. 


A slash (/) ona line by itself also tells SQL*Plus that you wish to run 
the command. Press [Return] at the end of the last line of the 
command. SQL*Plus prompts you with another line number. Type a 
slash and press [Return] again. SQL*Plus will execute the command. 
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The SQL Buffer 


Executing the Current 
SQL Command from the 
Command Prompt 


Running PL/SQL 
Blocks 


A blank line tells SQL*Plus that you have finished entering the 
command, but do not want to run it yet. Press [Return] at the end of 
the last line of the command. SQL*Plus prompts you with another line 
number. 


Press [Return] again; SQL*Plus now prompts you with the SQL*Plus 
command prompt. SQL*Plus does not execute the command, but 
stores the command (as it does any SQL command) in a part of 
memory called the SQL buffer. 


The area where SQL*Plus stores your most recently entered SQL 
command is called the SQL buffer. The command remains there until 
you enter a new SQL command. Thus, if you want to edit or re-run the 
current SQL command, you may do so without re-entering it. See 
Chapter 3 for details about editing or re-running a command stored in 
the buffer. 


SQL*Plus does not store the semicolon or the slash you type to execute 
a command in the SQL buffer. 


The SQL buffer is the default buffer. You can define other buffers, but 
SQL*Plus does not require the use of multiple buffers. Throughout this 
Guide, "buffer" and "SQL buffer" are synonymous unless the text 
explicitly states otherwise. See SET BUFFER in Appendix F for 
information on defining additional buffers. 


You can run (or re-run) the current SQL command by entering the RUN 
command or the / (slash) command at the command prompt. The 
RUN command lists the SQL command in the buffer before executing 
the command; the / command simply runs the SQL command. 


You can also use PL/SQL programs (called blocks) to manipulate data 
in the database. See your PL/SQL User's Guide and Reference for 
information on individual PL/SQL commands. 


PL/SQL blocks begin with DECLARE, BEGIN, or a block name. 
SQL*Plus treats PL/SQL blocks in the same manner as SQL commands, 
except that a semicolon (;) or a blank line does not terminate and 
execute a block. Terminate PL/SQL blocks by entering a period (.) by 
itself on a new line. 


SQL*Plus stores the blocks you enter in the SQL buffer. Execute the 
current block by issuing a RUN or / (slash) command. SQL*Plus sends 
the complete PL/SQL block to the ORACLE RDBMS for processing (as 
it does SQL commands). See your PL/SQL User's Guide and Reference for 
more information. 
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Running SQL*Plus 
Commands 


Example 2-4 
Entering a SQL*Plus 
Command 


You might enter and execute a PL/SQL block as follows: 


SQL> DECLARE ot L f Je k beg bea, 
2 x NUMBER := 100; 
3 BEGIN 
4 FOR i IN 1..10 Loop 
5 IF TRUNC(i / 2) = i / 2 THEN ~-i is even 
6 INSERT INTO temp VALUES (i, x, ‘i is even’); 
7 ELSE 
8 INSERT INTO temp VALUES (i, x, ‘i is odd’); 


9 END IF; 


10 x r= x + 100; 
ak END LOOP; 

12 END; 

13 se 

SQL> / 


PL/SQL procedure successfully completed. 


When you run a block, the SQL commands within the block may 
behave somewhat differently than they would outside of the block. See 
your PL/SQL User's Guide and Reference for detailed information on the 
PL/SQL language. 


You can use SQL*Plus commands to manipulate SQL commands and 
PL/SQL blocks, and to format and print query results. SQL*Plus treats 
SQL*Plus commands differently than SQL commands or PL/SQL 
blocks. For information on individual SQL*Plus commands, refer to 
the following chapters of this Guide. 


To speed up command entry, you can abbreviate many SQL*Plus 
commands to one or a few letters. Abbreviations for some SQL*Plus 
commands are described along with the commands in Chapters 3, 4, 
and 5, For abbreviations of all SQL*Plus commands, refer to the 
command descriptions in Chapter 6. 


This example shows how you might enter a SQL*Plus command to 
change the format used to display the column SAL of the sample table 
EMP. 


1. On the command line, enter this SQL*Plus command: 
SQL> COLUMN SAL FORMAT $99, 999 HEADING SALARY 


If you make a mistake, use [Backspace] to erase it and re-enter. 
When you have entered the line, press [Return]. SQL*Plus notes 
the new format and displays the SQL*Plus command prompt 
again, ready for a new command. 
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Understanding SQL*Plus 
Command Syntax 


2. Enter the RUN command to re-run the most recent query (from 
Example 2-3). SQL*Plus reprocesses the query and displays the 
results: 

SQL> RUN 


1 SELECT EMPNO, ENAME, JOB, SAL 
2* FROM EMP WHERE SAL < 2500 


EMPNO ENAME JOB SALARY 
7369 SMITH CLERK $800 
7499 ALLEN SALESMAN $1,600 
7521 WARD SALESMAN $1,250 
7654 MARTIN SALESMAN $1,250 
7782 CLARK MANAGER $2,450 
7844 TURNER SALESMAN $1,500 
7876 ADAMS CLERK $1,100 
7900 JAMES CLERK $950 
7934 MILLER CLERK $1,300 


The COLUMN command formatted the column SAL with a dollar sign 
($) and a comma (,), and gave it a new heading. The RUN command 
then re-ran the query of Example 2-3, which was stored in the buffer. 
SQL*Plus does not store SQL*Plus commands in the buffer. 


SQL*Plus commands have a different syntax from SQL commands or 
PL/SQL blocks. 


Continuing a Long SQL*Plus Command on Additional Lines You 
can continue a long SQL*Plus command by typing a hyphen at the end 
of the line and pressing [Return]. If you wish, you can type a space 
before typing the hyphen. SQL*Plus displays a right angle-bracket (>) 
as a prompt for each additional line. 


Ending aSQL*Plus Command You do not need to end a SQL*Plus 
command with a semicolon. When you finish entering the command, 
you can just press [Return]. However, if you wish, you can enter a 
semicolon at the end of a SQL*Plus command, 
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Variables that Affect 
Running Commands 


Saving Changes to the 
Database Automatically 


The SQL*Plus command SET controls many variables—called system 
variables—the settings of which affect the way SQL*Plus runs your 
commands. System variables control a variety of conditions within 
SQL*Plus, including default column widths for your output, whether 
SQL*Plus displays the number of records selected by a command, and 
your page size. System variables are also called SET command variables. 


The examples in this Guide are based on running SQL*Plus with the 
system variables at their default settings. Depending on the settings of 
your system variables, your output may appear slightly different than 
the output shown in the examples. (Your settings might differ from the 
default settings if you have a SQL*Plus LOGIN file on your computer.) 


For more information on system variables and their default settings, see 
the SET command in Chapter 6. For details on the SQL*Plus LOGIN 
file, refer to the subsection, "Setting Up Your SQL*Plus Environment" 
under "Saving Commands for Later Use" in Chapter 3 and to the 
SQLPLUS command in Chapter 6. 


To list the current setting of a SET command variable, enter SHOW 
followed by the variable name at the command prompt. See the SHOW 
command in Chapter 6 for information on other items you can list with 
SHOW. 


Through the SQL DML commands UPDATE, INSERT, and 
DELETE—which can be used within PL/SQL blocks—you specify 
changes you wish to make to the information stored in the database. 
SQL does not, however, make the changes permanent until you enter a 
SQL COMMIT command or a SQL DCL or DDL command such as 
CREATE TABLE. 


You need not defer committing these changes to the database until you 
enter a SQL COMMIT, DCL, or DDL command. The SQL*Plus 
autocommit feature can cause pending changes to be committed after 
each SQL command—including INSERT, UPDATE, and DELETE—and 
after each PL/SQL block you execute. 


You control the autocommit feature with the SQL*Plus SET command’s 
AUTOCOMMIT variable. It has these forms: 


SET AUTOCOMMIT ON Turns autocommit on. 


SET AUTOCOMMIT orF Turns autocommit off (the default). 
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Example 2-5 
Turning Autocommit 
On 


Stopping a Command 
while It Is Running 


Collecting Timing 
Statistics on 
Commands You Run 


To turn the autocommit feature on, enter: 
SQL> SET AUTOCOMMIT ON 


Until you change the setting of AUTOCOMMIT, SQL*Plus will 
automatically commit changes from each SQL command or PL/SQL 
block that specifies changes to the database. After each autocommit, 
SQL*Plus displays the following message: 


commit complete 


When the autocommit feature is turned on, you cannot roll back 
changes to the database. 


To turn the autocommit feature off again, enter the following command: 


SQL> SET AUTOCOMMIT OFF 


To confirm that AUTOCOMMIT is now set to OFF, enter the following 
SHOW command: 


SQL> SHOW AUTOCOMMIT 
autocommit OFF 


Suppose you have displayed the first page of a fifty-page report, and 
decide you do not need to see the rest of it. Press [Cancel]. (Refer to 
Table 2-1 at the beginning of this chapter to see how [Cancel] is labelled 
on your keyboard). SQL*Plus will stop the display and return to the 
command prompt. 


Note: Pressing [Cancel] will not stop the printing of a file that you have 
sent to a printer with the OUT clause of the SQL*Plus SPOOL 

command. (You will learn about printing query results in Chapter 4.) 
You can stop the printing of a file through your operating system; see 
your operating system manuals for information. 


Use the SQL*Plus command TIMING to collect and display data on the 
amount of computer resources used to run one or more commands or 
blocks. TIMING collects data for an elapsed period of time, saving the 
data on commands run during the period in a timing area. See 
TIMING in Chapter 6 and the Oracle installation and user’s manuals 
provided for your operating system for more information. 


To delete all timing areas, enter CLEAR TIMING at the command 
prompt. 
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Running Host 
Operating System 
Commands 


Running SQL*Forms 
Forms 


You can execute a host operating system command from the SQL*Plus 
command prompt. This is useful when you want to perform a task 
such as listing existing host operating system files. 


To run a host operating system command, enter the SQL*Plus 
command HOST followed by the host operating system command. For 
example, this SQL*Plus command runs a host command, DIRECTORY 
* SQL: 


SQL> HOST DIRECTORY *.SOL 


When the host command finishes running, the SQL*Plus command 
prompt appears again. 


If the RUNFORM option was enabled during SQL*Plus installation, 
you can also run a SQL*Forms form from the SQL*Plus command 
prompt. To run a form, enter the SQL*Plus command RUNFORM 
followed by the form name: 


SQL> RUNFORM myform 


Getting Help 


Listing a Table 
Definition 


Example 2-6 
Using the DESCRIBE 
Command 


While you use SQL*Plus, you may find that you need to list column 
definitions for a table, or start and stop the display that scrolls by. You 
may also need to interpret error messages you receive when youentera 
command incorrectly or when there is a problem with ORACLE or 
SQL"Plus. The following sections describe how to get help for those 
situations. 


To see the definitions of each column ina given table, use the SQL*Plus 
DESCRIBE command. 


To list the column definitions of the three columns in the sample table 
DEPT, enter: 


SQL> DESCRIBE DEPT 


The following output results: 


Name Null? Type 

DEP TNO NOT NULL NUMBER (2) 
DNAME CHAR (14) 
LOC CHAR (13) 
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Controlling the Display 


Interpreting Error 
Messages 


Example 2-7 
Interpreting an Error 
Message 


Note: DESCRIBE accesses information in the ORACLE data dictionary. 
You can also use SQL SELECT commands to access this and other 
information in the database. See your SQL Language Reference Manual 
and your SQL Language User's Guide for details. 


Suppose that you wish to stop and examine the contents of the screen 
while displaying a long report or the definition of a table with many 
columns. Press [Pause]. (Refer to Table 2-1 to see how [Pause] is 
labelled on your keyboard.) The display will pause while you examine 
it. To continue, press [Resume]. 


If you wish, you can use the PAUSE variable of the SQL*Plus SET 
command to have SQL*Plus pause after displaying each screen of a 
query or report. Refer to SET in Chapter 6 for details. 


If SQL*Plus detects an error in a command, it will try to help you out 
by displaying an error message. 


For example, if you misspell the name of a table while entering a 
command, an error message will tell you that the table or view does not 
exist: 

SQL> DESCRIBE DPT 

ERROR: 

ORA-0942: table or view does not exist 


You will often be able to figure out how to correct the problem from the 
message alone. If you need further explanation, take one of the 
following steps to determine the cause of the problem and how to 
correct it: 


+ If the error is a numbered error for the SQL*Plus COPY 
command, look up the message in Appendix A of this Guide. 


+ If the error is a numbered error beginning with the letters 
"ORA", look up the message in the ORACLE Error Messages and 
Codes manual or in the Oracle installation and user’s manual(s) 
provided for your operating system to determine the cause of 
the problem and how to correct it. 


+ If the error is unnumbered, look up correct syntax for the 
command that generated the error in Chapter 6 of this Guide 
for a SQL*Plus command, in the SQL Language Reference 
Manual for a SQL command, or in the PL/SQL User's Guide and 
Reference for a PL/SQL block. Or, contact your DBA. 
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CHAPTER 


MANIPULATING 
COMMANDS 


his chapter helps you learn to manipulate SQL*Plus commands, 
SQL commands, and PL/SQL blocks, and covers the following 
topics: 
* editing a SQL*Plus command 


* using SQL*Plus commands to list and modify the command 
currently stored in the buffer 


* editing commands with a system editor 


* creating and modifying command files to hold commands for 
later use 


+ retrieving and running command files 
saving SQL*Plus environment settings 


writing interactive commands that include user variables and 
substitution variables 


* passing parameters to a command file 


Read this chapter while sitting at your computer, and try out the 
examples shown. Before beginning, make sure you have access to the 
sample tables described in Chapter 1. 
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Editing Commands 
Because SQL*Plus does not store SQL*Plus commands in the buffer, 
you edit a SQL*Plus command entered directly to the command 
prompt by using [Backspace] or by re-entering the command. 
You can use a number of SQL*Plus commands to edit the SQL 
command or PL/SQL block currently stored in the buffer. Or, you can 
use a host operating system editor to edit the buffer contents. 
Table 3-1 shows several SQL*Plus commands that allow you to 
examine or change the command in the buffer without re-entering the 
command. 

TABLE 3-1 Command Abbreviation Purpose 

SQL*Plus Editing Commands 
APPEND text A text add text at the end of a line 
CHANGE /old/new C /old/new change old to new in a line 
CHANGE /text C /text delete text from a line 
CLEAR BUFFER CL BUFF delete all lines 
DEL (none) delete a line 
INPUT I add one or more lines 
INPUT text I text add a line consisting of text 
LIST L list all lines in the SQL buffer 
LIST n Ln or n list one line 
LIST * L* list the current line 
LIST LAST L LAST list the last line 
LIST m n Lmn list a range of lines (m to n) 


You will find these commands useful if you mistype a command or 
wish to modify a command you have entered. 
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Listing the Buffer 
Contents 


Example 3-1 
Listing the Buffer 
Contents 


Editing the Current 


Line 


Example 3-2 
Making an Error in 
Command Entry 


Any editing command other than LIST affects only a single line in the 
buffer. This line is called the current line. Itis marked with an asterisk 
when you list the current command or block. 


Suppose you want to list the current command. Use the LIST 
command as shown below. (If you have EXITed SQL*Plus or entered 
another SQL command or PL/SQL block since following the steps in 
Example 2-3, perform the steps in that example again before 
continuing.) 
SQL> LIST 

1 SELECT EMPNO, ENAME, JOB, SAL 

2* FROM EMP WHERE SAL < 2500 


Notice that the semicolon you entered at the end of the SELECT 
command is not listed. This semicolon is necessary to mark the end of 
the command when you enter it, but SQL*Plus does not store it in the 
SQL buffer. This makes editing more convenient, since it means you 
can add a new line to the end of the buffer without removing a 
semicolon from the line that was previously the last. 


The SQL*Plus CHANGE command allows you to edit the current line. 
Various actions determine which line is the current line: 


* LIST a given line to make it the current line. 


+ When you LIST or RUN the command in the buffer, the last 
line of the command becomes the current line. (Using the slash 
(/) command to run the command in the buffer does not affect 
the current line, however.) 

+ Ifyou get an error message, the line containing the error 
automatically becomes the current line. 


Suppose you try to select the DEPTNO column but mistakenly enter it 
as DPTNO. Enter the following command, purposely misspelling 
DEPTNO in the first line: 


SQL> SELECT DPTNO, ENAME, SAL 
2 FROM EMP 
3 WHERE DEPTNO = 10; 


You see this message on your screen: 
SELECT DPTNO, ENAME, SAL 
* 


ERROR at line 1: 
ORA-0904: invalid column name 
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Example 3-3 
Correcting the Error 


Examine the error message; it indicates an invalid column name in line 
1 of the query. The asterisk shows the point of error—the mistyped 
column DPTNO. 


Instead of re-entering the entire command, you can correct the mistake 
by editing the command in the buffer. The line containing the error is 
now the current line. Use the CHANGE command to correct the 
mistake. This command has three parts, separated by slashes or any 
other non-alphanumeric character: 

* the word CHANGE or the letter C 

» the sequence of characters you want to change 

+ the sequence of characters to which you want to change it 
The CHANGE command finds the first occurrence in the current line of 
the character sequence to be changed, and changes it to the new 
sequence. If you wish to re-enter an entire line, you do not need to use 
the CHANGE command: re-enter the line by typing the line number 
followed by a space and the new text and pressing [Return]. 


To change DPTNO to DEPTNO, change the line with the CHANGE 
command: 


SQL> CHANGE /DPTNO/DEPTNO 
The corrected line appears on your screen: 


1* SELECT DEPTNO, ENAME, SAL 


Now that you have corrected the error, you can use the RUN command. 
to run the command again: 


SQL> RUN 
SQL*Plus lists the command, and then runs it: 


1 SELECT DEPTNO, ENAME, SAL 
2 FROM EMP 
3* WHERE DEPTNO = 10 


DEPTNO ENAME SALARY 
10 CLARK $2,450 
10 KING $5,000 
10 MILLER $1,300 


Note that the column SAL retains the format you gave it in Example 
2-4. (If you have left SQL*Plus and started again since performing 
Example 2-4, the column has reverted to its original format.) 
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Adding a New Line 
Example 3-4 
Adding a Line 
Appending Text to a 
Line 
Example 3-5 
Appending Text toa 
Line 


For information about the significance of case ina CHANGE command 
and on using wildcards to specify blocks of text ina CHANGE 
command, refer to CHANGE in Chapter 6. 


To insert a new line after the current line, use the INPUT command. 


Suppose you want to add a fourth line to the SQL command you 
modified in Example 3-3. Since line 3 is already the current line, enter 
INPUT (which may be abbreviated to I) and press {Return]. SQL*Plus 
prompts you for the new line: 


SQL> INPUT 
4 


Enter the new line. Then press [Return]. SQL*Plus prompts you again 
for a new line: 


4 ORDER BY SAL 
5 


Press [Return] again to indicate that you will not enter any more lines, 
and then use RUN to verify and rerun the query. 


To add text to the end of a line in the buffer, use the APPEND 
command: 


1. Use the LIST command (or just the line number) to list the line you 
want to change. 


2. Enter APPEND followed by the text you want to add. If the text you 
want to add begins with a blank, separate the word APPEND from 
the first character of the text by two blanks: one to separate 
APPEND from the text, and one to go into the buffer with the text. 


To append a space and the clause DESC to line 4 of the current query, 


first list line 4: 


SQL> LIST 4 
4* ORDER BY SAL 


Next, enter the following command (be sure to type two spaces 
between APPEND and DESC): 


SQL> APPEND DESC 
4* ORDER BY SAL DESC 


Use RUN to verify and rerun the query. 
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Deleting a Line 


Editing Commands 
with a System Editor 


To delete a line in the buffer, use the DEL command: 


1. Use the LIST command (or just the line number) to list the line you 
want to delete. 


2. Enter DEL. 


DEL makes the following line of the buffer (if any) the current line. 
Thus, you can delete several consecutive lines by making the first of 
them the current line, then entering DEL several times. 


Your host computer’s operating system has one or more text editors 
that you can use to create and edit host system files. Text editors 
perform the same general functions as the SQL*Plus editing commands, 
but you may find them more familiar. 


You can run your host operating system’s default text editor without 
leaving SQL*Plus by entering the EDIT command: 


SQL> EDIT 


EDIT loads the contents of the buffer into your system’s default text 
editor. You can then edit the text with the text editor’s commands. 
When you tell the text editor to save edited text and then exit, the text is 
saved back into the current buffer. 


To load the buffer contents into a text editor other than the default, use 
the SQL*Plus DEFINE command to define a variable, EDITOR, to hold 
the name of the editor. For example, to define the editor to be used by 
EDIT as EDT, enter the following command: 


SQL> DEFINE _EDITOR = EDT 
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eT 
Saving Commands for Later Use 


Storing Commands in 
Command Files 


Creating a Command File 
by Saving the Buffer 
Contents 


Example 3-5 
Saving the Current 
Command 


Through SQL*Plus, you can store one or more commands in a file, 
called a command file. After you create a command file, you can 
retrieve, edit, and run it. Use command files to save commands for use 
over time, especially complex commands or PL/SQL blocks. 


You can store one or more SQL commands, PL/SQL blocks, and 
SQL*Plus commands in command files. You create a command file 
within SQL*Plus in one of three ways: 


* enter a command and save the contents of the buffer 


+ use INPUT to enter commands and then save the buffer 
contents 


+ use EDIT to create the file from scratch using a host system text 
editor 


Because SQL*Plus commands are not stored in the buffer, you must use 
one of the latter two methods to save SQL*Plus commands. 


To save the current SQL command or PL/SQL block for later use, enter 
the SAVE command. Follow the command with a file name: 


SQL> SAVE file name 


SQL*Plus adds the extension SQL to the file name to identify it as a 
SQL query file. If you wish to save the command or block under a 
name with a different file extension, type a period at the end of the file 
name, followed by the extension you wish to use. 


Note that within SQL*Plus, you separate the extension from the file 
name with a period. Your operating system may use a different 
character or a space to separate the file name and the extension. 


First, LIST the buffer contents to see your current command: 


SQL> LIST 
1 SELECT DEPTNO, ENAME, SAL 
2 FROM EMP 
3 WHERE DEPTNO = 10 
4* ORDER BY SAL DESC 


If the query shown is not in your buffer, re-enter the query now. Next, 
enter the SAVE command followed by the file name DEPTINFO: 


SQL> SAVE DEPTINFO 
Created file DEPTINFO 
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Creating a Command File 
by Using INPUT and 
SAVE 


Example 3-6 
Saving Commands 
Using INPUT and SAVE 


You can verify that the command file DEPTINFO exists by entering the 
SQL*Plus HOST command followed by your host operating system’s 
file listing command: 


SQL> HOST your_host’s file listing_command 


You can use the same method to save a PL/SQL block currently stored 
in the buffer. 


If you use INPUT to enter your commands, you can enter SQL*Plus 
commands (as well as one or more SQL commands or PL/SQL blocks) 
into the buffer. You must enter the SQL*Plus commands first, and the 
SQL command(s) or PL/SQL block(s) last—just as you would if you 
were entering the commands directly to the command prompt. 


You can also store a set of SQL*Plus commands you plan to use with 
many different queries by themselves in a command file. 


Suppose you have composed a query to display a list of salespeople 
and their commissions. You plan to run it once a month to keep track 
of how well each employee is doing. To compose and save the query 
using INPUT, you must first clear the buffer: 


SQL> CLEAR BUFFER 


Next, use INPUT to enter the command (be sure not to type a 
semicolon at the end of the command): 


SQL> INPUT 

1 COLUMN ENAME HEADING SALESMAN 
COLUMN SAL HEADING SALARY FORMAT $99,999 
COLUMN COMM HEADING COMMISSION FORMAT $99,990 
SELECT EMPNO, ENAME, SAL, COMM 
FROM EMP 
WHERE JOB = ’ SALESMAN" 


Yaannun 


The zero at the end of the format model for the column COMM tells 
SQL*Plus to display a zero instead of a blank when the value of COMM 
is zero for a given row. The zero is only necessary when you use other 
format models on the given column. Format models and the COLUMN 
command are described in more detail in Chapter 4. 


Now use the SAVE command to store your query ina file called SALES 
with the extension SQL: 


SQL> SAVE SALES 
Created file SALES 
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Creating Command Files 
with a System Editor 


Note that you do not type a semicolon at the end of the query; if you 
did include a semicolon, SQL*Plus would attempt to run the buffer 
contents. The SQL*Plus commands in the buffer would produce an 
error because SQL"Plus expects to find only SQL commands in the 
buffer. You will learn how to run a command file later in this chapter. 


To input more than one SQL command, leave out the semicolons on all 
the SQL commands. Then, use APPEND to add a semicolon to all but 
the last command (SAVE appends a slash to the end of the file 
automatically; this slash tells SQL*Plus to run the last command when 
you run the command file.) 


To input more than one PL/SQL block, enter the blocks one after 
another without including a period or a slash on a line between blocks. 
Then, for each block except the last, list the last line of the block to 
make it current and use INPUT in the following form to insert a slash 
on a line by itself: 


INPUT / 


You can also create a command file with a host operating system text 
editor by entering EDIT followed by the name of the file, for example: 


SQL> EDIT SALES 


Like the SAVE command, EDIT adds the file name extension SQL to 
the name unless you type a period and a different extension at the end 
of the file name. When you save the command file with the text editor, 
it is saved back into the same file. 


You must include a semicolon at the end of each SQL command and a 
period on a line by itself after each PL/SQL block in the file. (You can 
include multiple SQL commands and PL/SQL blocks.) 


When you create a command file using EDIT, you can also include 
SQL*Plus commands at the end of the file. You cannot do this when 
you create a command file using the SAVE command because SAVE 
appends a slash to the end of the file. This slash would cause SQL*Plus 
to run the command file twice, once upon reaching the semicolon at the 
end of the last SQL command (or the slash after the last PL/SQL block), 
and once upon reaching the slash at the end of the file. 
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Placing Comments in 
Command Files 


Using the REMARK 
Command 


Using /*...*/ 


Using PL/SQL "--" Style 
Comments 


You can enter comments in a command file in one of three ways: 


+ using the SOL*Plus REMARK command 
* using the SQL comment delimiters, /*...*/ 
* using PL/SQL "--" style comments 


Use the REMARK command on a line by itself in the command file, 

followed by comments on the same line. To continue the comments on 
additional lines, enter additional REMARK commands. Do not placea 
REMARK command between different lines of a single SQL command. 


REMARK Commissions report 

REMARK to be run monthly. 

COLUMN ENAME HEADING SALESMAN 

COLUMN SAL HEADING SALARY FORMAT $99,999 
COLUMN COMM HEADING COMMISSION FORMAT $99,990 
REMARK Includes only salesmen. 

SELECT EMPNO, ENAME, SAL, COMM 

FROM EMP 

WHERE JOB = ’ SALESMAN’ 


Enter the SQL comment delimiters, /*...*/, on separate lines in your 
command file, or, on the same line as a SQL command or a line ina 
PL/SQL block. The comments can span multiple lines: 


/* Commissions report 

to be run monthly. */ 

COLUMN ENAME HEADING SALESMAN 

COLUMN SAL HEADING SALARY FORMAT $99,999 

COLUMN COMM HEADING COMMISSION FORMAT $99,990 
SELECT EMPNO, ENAME, SAL, COMM 

FROM EMP 

WHERE JOB = ‘SALESMAN’ /* Includes only salesmen. */ 


If you enter a SQL comment directly at the command prompt, 
SQL*Plus does not store the comment in the buffer. 


You can use "--" style comments only within PL/SQL blocks. Enter the 
comment following a command in a block, on the same line. The 
comment must end on the same line; there is no ending delimiter: 


DECLARE ~-block for reporting monthly sales 
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Retrieving Command 
Files 


Example 3-7 
Retrieving a Command 
File 


Running Command 
Files 


If you want to place the contents of a command file in the buffer, you 
must retrieve the command from the file in which it is stored. You can 
retrieve a command file in using the SQL*Plus command GET. 


Just as you can save a query from the buffer to a file with the SAVE 
command, you can retrieve a query froma file to the buffer with the 
GET command: 


SQL> GET file name 


SQL*Plus adds a period and the extension SQL to the file name unless 
you type a period at the end of the file name followed by a different 
extension. 


Suppose you need to retrieve the SALES file in a later session. (You can 
simulate that need, if you wish, by entering the command CLEAR 
BUFFER.) You can retrieve the file by entering the GET command. To 
retrieve the file SALES, enter: 
SQL> GET SALES 

1 COLUMN ENAME HEADING SALESMAN 

2 COLUMN SAL HEADING SALARY FORMAT $99,999 

3 COLUMN COMM HEADING COMMISSION FORMAT $99, 990 

4 SELECT EMPNO, ENAME, SAL, COMM 

5 FROM EMP 

6* WHERE JOB = ‘SALESMAN’ 


SQL*Plus retrieves the contents of the file SALES with the extension 
SQL into the SQL buffer and lists it on the screen. Then you can edit 
the command further. If the file did not contain SQL*Plus commands, 
you could also execute it with the RUN command. 


The START command retrieves a command file and runs the 
command(s) it contains. Use START to run a command file containing 
SQL commands, PL/SQL blocks, and/or SQL*Plus commands. Follow 
the word START with the name of the file: 


START file_name 


If the file has an extension SQL, you need not add the period and the 
extension SQL to the file name. 
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Example 3-8 
Running a Command 
File 


Running a Command File 
as You Start SQL*Plus 


To retrieve and run the command stored in SALES.SQL, enter: 
SQL> START SALES 
SQL*Plus runs the commands in the file SALES and displays the results 


of the commands on your screen, formatting the query results 
according to the SQL*Plus commands in the file: 


EMPNO SALESMAN SALARY COMMISSION 
7499 ALLEN $1,600 $300 
7521 WARD $1,250 $500 
7654 MARTIN $1,250 $1,400 
7844 TURNER $1,500 $0 


To see the commands as SQL*Plus "enters" them, you can set the ECHO 
variable of the SET command to ON. The ECHO variable controls the 
listing of the commands in command files run with the START 
command and the @ command. Setting the ECHO variable to OFF 
suppresses the listing. 


You can also use the @ ("at" sign) command to run a command file: 
SQL> @SALES 


The @ command lists and runs the commands in the specified 
command file in the same manner as START. SET ECHO affects the @ 
command as it affects the START command. 


START and @ leave the last SQL command or PL/SQL block in the 
command file in the buffer. 


To run a command file as you start SQL*Plus, use one of the following 
four options: 


* Follow the SQLPLUS command with your username, a slash, 
your password, a space, @, and the name of the file: 


SOLPLUS SCOTT/TIGER @SALES 


SQL*Plus starts and runs the command file. 


* Follow the SQLPLUS command and your username witha 
space, @, and the name of the file: 


SQLPLUS SCOTT @SALES 


SQL*Plus prompts you for your password, starts, and runs the 
command file. 
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Nesting Command 
Files 


Modifying Command 
Files 


» Include your username as the first line of the file. Follow the 
SOLPLUS command with @ and the file name. SQL*Plus 
prompts for your password, starts, and runs the file. 

+ Include your username, a slash (/), and your password as the 
first line of the file. Follow the SOQLPLUS command with @ 
and the file name. SQL*Plus starts and runs the file. 


To run a series of command files in sequence, first create a command 
file containing several START commands, each followed by the name 
of a command file in the sequence. Then run the command file 
containing the START commands. For example, you could include the 
following START commands in a command file named SALESRPT: 
START QISALES 

START Q2SALES 

START Q3SALES 

START Q4SALES 

START YRENDSLS 


You can modify an existing command file in two ways: 


« using the EDIT command 

« using GET, the SQL*Plus editing commands, and SAVE 
To edit an existing command file with the EDIT command, follow the 
word EDIT with the name of the file. For example, to edit an existing 
file named PROFIT that has the extension SQL, enter the following 
command: 


SQL> EDIT PROFIT 
Remember that EDIT assumes the file extension SQL if you do not 
specify one. 


To edit an existing file using GET, the SQL*Plus editing commands, 
and SAVE, first retrieve the file with GET, then edit the file with the 
SQL*Plus editing commands, and finally save the file with the SAVE 
command. 
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Exiting from a 
Command File with a 
Return Code 


Setting Up Your 
SQL* Plus Environment 


Note that if you want to replace the contents of an existing command 
file with the command or block in the buffer, you must use the SAVE 
command and follow the file name with the word REPLACE. For 
example: 


SQL> GET MYREPORT 

1* SELECT * FROM EMP 
SQL> C/*/ENAME, JOB 

1* SELECT ENAME, JOB FROM EMP 
SQL> SAVE MYREPORT REPLACE 
Wrote file MYREPORT 


If you want to append the contents of the buffer to the end of an 
existing command file, use the SAVE command and follow the file 
name with the word APPEND: 


SQL> SAVE file_name APPEND 


If your command file generates a SQL error while running from a batch 
file on the host operating system, you may want to abort the command 
file and exit with a return code. Use the SQL*Plus command 
WHENEVER SQLERROR to do this; see WHENEVER SQLERROR in 
Chapter 6 for more information. 


You may wish to set up your SQL*Plus environment in a particular 
way (such as showing the current time as part of the SOL*Plus 
command prompt) and then re-use those settings with each session. 
You can do this through a host operating system file called LOGIN 
with the file extension SQL (also called your User Profile). The exact 
name of this file is system-dependent; see the Oracle installation and 
user’s manual(s) provided for your operating system for the precise 
name. 


The Oracle-supplied command file DEMOBLD mentioned in 
conjunction with the sample tables in Chapter 1 creates a LOGIN file in 
your current directory. When first created, this file is empty except for 
a placeholder DEFINE statement. 


You can add any SQL commands, PL/SQL blocks, or SQL*Plus 
commands to this file; when you start SQL*Plus, it automatically 
searches for your LOGIN file (first in your local directory and then ona 
system-dependent path) and runs the commands it finds there. (You 
may also have a Site Profile. See the SQLPLUS command in Chapter 6 
for more information on the relationship of Site and User profiles.) 
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Modifying Your LOGIN 
File 


If yourun DEMOBLD and a LOGIN file already exists in your current 
directory, DEMOBLD asks whether you wish to save the current copy 
as LOGIN with the extension OLD. If you want to keep the current 
LOGIN file, answer yes and then rename LOGIN with the extension 
OLD to LOGIN with the extension SQL. 


Note: DEMODROP does not delete the LOGIN file; it deletes only the 
sample tables. 


You can modify your LOGIN file just as you would any other 
command file. You may wish to add some of the following commands 
to the LOGIN file: 


SET COMPATIBILITY Followed by V5 or V6, sets compatibility to the 
version of ORACLE you specify. Setting 
COMPATIBILITY to V5 allows you to run 
command files created with Version 5 of ORACLE. 


SET CRT Followed by a SQL*Forms CRT name, enables you 
to run SQL*Forms forms with RUNFORM using 
the specified CRT definition. 


SET NUMFORMAT Followed by a number format (such as $99,999), 
sets the default format for displaying numbers in 
query results. 

SET PAGESIZE Followed by a number, sets the number of lines per 
page. 

SET PAUSE Followed by ON, causes SQL*Plus to pause at the 


beginning of each page of output (SQL*Plus 
continues scrolling after you enter [Return]). 
Followed by text, sets the text to be displayed each 
time SQL*Plus pauses (you must also set PAUSE to 
ON). 

SET TIME Followed by ON, displays the current time before 
each command prompt. 


See the SET command in Chapter 6 for more information on these and 
other SET command variables you may wish to set in your SQL*Plus 
LOGIN file. 
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SL 
Writing Interactive Commands 


The following features of SQL*Plus make it possible for you to set up 
command files that allow end-user input: 


+ defining user variables 

* substituting values in commands 

* using the START command to provide values 
* prompting for values 


Defining User You can define variables, called user variables, for repeated use in a 

Variables single command file by using the SQL*Plus command DEFINE. Note 
that you can also define user variables to use in titles and to save you 
keystrokes (by defining a long string as the value for a variable witha 
short name). 


Example 3-9 To define a user variable EMPLOYEE and give it the value "SMITH", 
Defining a User enter the following command: 


Variable SQL> DEFINE EMPLOYEE = SMITH 


To confirm the definition of the variable, enter DEFINE followed by the 
variable name: 


SQL> DEFINE EMPLOYEE 


SQL*Plus lists the definition: 


DEFINE EMPLOYEE = "SMITH" (CHAR) 


To list all user variable definitions, enter DEFINE by itself at the 
command prompt. Note that any user variable you define explicitly 
through DEFINE takes only CHAR values (i.e., the value you assign to 
the variable is always treated as a CHAR datatype). You can define a 
user variable of datatype NUMBER implicitly through the ACCEPT 
command. You will learn more about the ACCEPT command later in 
this chapter. 


To delete a user variable, use the SQL*Plus command UNDEFINE 
followed by the variable name. 
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Using Substitution 
Variables 


Where and how to Use 
Substitution Variables 


Suppose you want to write a query like the one in SALES (see Example 
3-6) to list the employees with various jobs, not just those whose job is 
SALESMAN. You could do that by editing a different CHAR value 
into the WHERE clause each time you run the command, but there is an 
easier way. 


By using a substitution variable in place of the value SALESMAN in the 
WHERE clause, you can get the same results you would get if you had 
written the values into the command itself. 


A substitution variable is a user variable name preceded by one or two 
ampersands (&). When SQL*Plus encounters a substitution variable in 
a command, SQL*Plus executes the command as though it contained 
the value of the substitution variable, rather than the variable itself. 


For example, if the variable SORTCOL has the value JOB, and the 
variable MYTABLE has the value EMP, SQL*Plus executes the 
commands 


SQL> BREAK ON &SORTCOL 
SQL> SELECT &SORTCOL, SAL 
2 FROM &MYTABLE 
3 ORDER BY &SORTCOL; 


as if they were: 


SQL> BREAK ON JOB 
SQL> SELECT JOB, SAL 
2 FROM EMP 
3 ORDER BY JOB; 


(The BREAK command suppresses duplicate values of the column 
named in SORTCOL; BREAK is discussed in Chapter 4.) 


You can use substitution variables anywhere in SQL and SQL*Plus 
commands, except as the first word entered at the command prompt. 
When SQL*Plus encounters an undefined substitution variable in a 
command, SQL*Plus prompts you for the value. 


You can enter any string at the prompt, even one containing blanks and 
punctuation. If the SQL command containing the reference should 
have quote marks around the variable and you do not include them 
there, the user must include the quotes when prompted. 


SQL*Plus reads your response from the keyboard, even if you have 
redirected terminal input or output to a file. If a terminal is not 
available (if, for example, you run the command file in batch mode), 
SQL"*Plus uses the redirected file. 
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After you enter a value at the prompt, SOL*Plus lists the line containing 
the substitution variable twice: once before substituting the value you 
enter and once after substitution. You can suppress this listing by 
setting the SET command variable VERIFY to OFF. 


Example 3-10 Create a command file named STATS, to be used to calculate a 
Using Substitution subgroup statistic (the maximum value) on a numeric column: 


Variables SQL> CLEAR BUFFER 
SQL> INPUT 
L SELECT &GROUP_COL, 
2 MAX (&NUMBER_COL) MAXIMUM 
3 FROM &TABLE 
4 GROUP BY &GROUP_COL 
5 


SQL> SAVE STATS 
Created file STATS 


Now run the command file STATS and respond as shown below to the 
prompts for values: 


SQL> @STATS 

Enter value for group_col: JOB 
old 1: SELECT &GROUP_COL, 
new l: SELECT JOB, 

Enter value for number col: SAL 


old 2: MAX (&NUMBER_COL) MAXIMUM 
new 2: MAX (SAL) MAXIMUM 

Enter value for table: EMP 

old 3: FROM &TABLE 

new 3: FROM EMP 


Enter value for group_col: JOB 
old 4: GROUP BY &GROUP_COL 
new 4: GROUP BY JOB 


SQL*Plus displays the following output: 


JOB MAXIMUM 
ANALYST 3000 
CLERK 1300 
MANAGER 2975 
PRESIDENT 5000 
SALESMAN 1600 
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Avoiding Unnecessary 
Prompts for Values 


If you wish to append characters immediately after a substitution 
variable, use a period to separate the variable from the character. For 
example, 

SQL> SELECT * FROM EMP WHERE EMPNO='&X.01'; 

Enter value for X: 123 


will be interpreted as: 
SQL> SELECT * PROM EMP WHERE EMPNO=' 12301"; 


Suppose you wanted to expand the file STATS to include the 
minimum, sum, and average of the "number" column. You may have 
noticed that SQL*Plus prompted you twice for the value of 
GROUP_COL and once for the value of NUMBER_COL in Example 
3-10, and that each GROUP_COL or NUMBER_COL had a single 
ampersand in front of it. If you were to add three more 
functions—using a single ampersand before each—to the command 
file, SQL*Plus would prompt you a total of four times for the value of 
the number column. 


You can avoid being re-prompted for the group and number columns 
by adding a second ampersand in front of each GROUP_COL and 
NUMBER_COL in STATS. SQL*Plus automatically DEFINEs any 
substitution variable preceded by two ampersands, but does not 
DEFINE those preceded by only one ampersand. Thus, when 
SQL*Plus encounters a substitution variable more than once during a 
session, SQL*Plus uses the DEFINEd values for substitution variables 
preceded by two ampersands, and prompts again for substitution 
variables preceded by one ampersand. This feature would also be 
useful if you wanted to run the file using the same GROUP_COL and 
NUMBER_COL in a different table. 
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Example 3-11 
Using Double 
Ampersands 


To expand the command file STATS using double ampersands and 
then run the file, first suppress the display of each line before and after 
substitution: 


SQL> 


SET VERIFY OFF 


Now retrieve and edit STATS by entering the following commands: 


SQL> 


2* 
SQL> 
2* 
SQL> 
2x 
SQL> 
Bi 
4i 
Si 
6i 
SQL> 
1x 
SQL> 
1+ 
SQL> 
7k 
SQL> 
7x 
SQL> 


GET STATS 
SELECT &GROUP_COL, 

MAX (&NUMBER_ COL) MAXIMUM 
FROM &TABLE 
GROUP BY s&GROUP_COL 
2 
MAX (&NUMBER_COL) MAXIMUM 
APPEND , 
MAX (&NUMBER_COL) MAXIMUM, 
C /&/&6 
MAX (&&NUMBER_ COL) MAXIMUM, 
Tr 
MIN (&&NUMBER_COL) MINIMUM, 
SUM(&&NUMBER_COL) TOTAL, 
AVG (&&NUMBER_COL) AVERAGE 


1 

SELECT &GROUP_COL, 

C /&/&6 

SELECT &&GROUP_COL, 

7 

GROUP BY &GROUP_COL 
C /&/&8 

GROUP BY &&GROUP_COL 
SAVE STATS2 


created file STATS2 
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Restrictions 


System Variables 


Finally, run the command file STATS2 and respond to the prompts for 
values as follows: 

SQL> START STATS2 

Enter value for group_col: JOB 

Enter value for number_col: SAL 

Enter value for table: EMP 


SQL*Plus displays the following output: 


JOB MAXIMUM MINIMUM TOTAL AVERAGE 
ANALYST 3000 3000 6000 3000 
CLERK 1300 800 4150 1037.5 
MANAGER 2975 2450 8275 2758.33333 
PRESIDENT 5000 5000 5000 5000 
SALESMAN 1600 1250 5600 1400 


Note that you were prompted for the values of NUMBER_COL and 
GROUP_COL only once. If you were to run STATS2 again during the 
current session, you would be prompted for TABLE (because its name 
has a single ampersand and the variable is therefore not DEFINEd) but 
not for GROUP_COL or NUMBER_COL (because their names have 
double ampersands and the variables are therefore DEFINEd). 


Before continuing, set the system variable VERIFY back to ON: 


SQL> SET VERIFY ON 


You cannot use substitution variables in the buffer editing commands, 
APPEND, CHANGE, DEL, and INPUT, nor in other commands where 
substitution would be meaningless, such as REMARK and TIMING. 
The buffer editing commands, APPEND, CHANGE, and INPUT, treat 
text beginning with "&" or "&&" literally, as any other text string. 


The following system variables, specified with the SQL*Plus SET 
command, affect substitution variables: 


SET SCAN Turns substitution on and off. 

SET DEFINE Defines the substitution character (by default the 
ampersand "&"). 

SET ESCAPE Defines an escape character you can use before the 


substitution character. The escape character 
instructs SQL*Plus to treat the substitution 
character as an ordinary character rather than as a 
request for variable substitution. The default 
escape character is a backslash (\). 
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Passing Parameters 
through the START 
Command 


SET VERIFY ON Lists each line of the command file before and after 
substitution. 

SET CONCAT Defines the character that separates the name of a 
substitution variable or parameter from characters 
that immediately follow the variable or 
parameter—by default the period (.). 


Refer to SET in Chapter 6 for more information on these system 
variables. 


You can bypass the prompts for values associated with substitution 
variables by passing values to parameters in a command file through 
the START command. 


You do this by placing an ampersand (&) followed by a numeral in the 
command file in place of a substitution variable. Each time you run 
this command file, START replaces each &1 in the file with the first 
value (called an argument) after START file_name, then replaces each 
&2 with the second value, and so forth. 


For example, you could include the following commands ina 
command file called MYFILE: 


SELECT * FROM EMP 
WHERE JOB=' 61° 
AND SAL=&2 


In the following START command, SQL*Plus would substitute CLERK 
for &1 and 7900 for &2 in the command file MYFILE: 


SQL> START MYFILE CLERK 7900 
When you use arguments with the START command, SQL*Plus 


DEFINEs each parameter in the command file with the value of the 
appropriate argument. 
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Example 3-12 
Passing Parameters 
through START 


To create a new command file based on SALES that takes a parameter 
specifying the job to be displayed, enter: 


SQL> GET SALES 
1 COLUMN ENAME HEADING SALESMAN 
COLUMN SAL HEADING SALARY FORMAT $99,999 
COLUMN COMM HEADING COMMISSION FORMAT $99,990 
SELECT EMPNO, ENAME, SAL, COMM 
FROM EMP 
6* WHERE JOB = ‘SALESMAN’ 
SQL> CHANGE /SALESMAN/&1 
6* WHERE JOB = '&l¢ 
SQL> 1 
1* COLUMN ENAME HEADING SALESMAN 
SQL> CHANGE /SALESMAN/&1 
1* COLUMN ENAME HEADING &1 
SQL> SAVE ONEJOB 
Created file ONEJOB 


Own 


Now run the command with the parameter CLERK. 
SQL> START ONEJOB CLERK 
SQL*Plus lists the line of the SQL command that contains the 


parameter, before and after replacing the parameter with its value, and 
then displays the output: 





old 3: WHERE JOB = '61' 
new 3: WHERE JOB = ‘CLERK’ 
EMPNO CLERK SALARY COMMISSION 
7369 SMITH $800 
7876 ADAMS $1,100 
7900 JAMES $950 
7934 MILLER $1,300 


You can use any number of parameters in a command file. Within a 
command file, you can refer to each parameter any number of times, 
and can include the parameters in any order. 


Note that you cannot use parameters when you run a command with 
RUN or slash (/). You must store the command in a command file and 
run it with START. 


Before continuing, return the column ENAME to its original heading by 
entering the following command: 


SQL> COLUMN ENAME CLEAR 
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Communicating with 
the User 


Prompting for and 
Accepting User Variable 
Values 


Example 3-13 
Prompting for and 
Accepting Input 


Three SQL*Plus commands—PROMPT, ACCEPT, and PAUSE—heip 
you communicate with the end user. These commands enable you to 
send messages to the screen and receive input from the user, including 
a simple [Return]. You can also use PROMPT and ACCEPT to 
customize the prompts for values SQL*Plus automatically generates for 
substitution variables. 


Through PROMPT and ACCEPT, you can send messages to the end 
user and accept values as end-user input. PROMPT simply displays a 
message you specify on-screen; use it to give directions or information 
to the user. ACCEPT prompts the user for a value and stores it in the 
user variable you specify. Use PROMPT in conjunction with ACCEPT 
when your prompt for the value spans more than one line. 


To direct the user to supply a report title and to store the input in the 
variable MYTITLE for use in a subsequent query, first clear the buffer: 


SQL> CLEAR BUFFER 


Next, set up a command file as shown below: 


SQL> INPUT 
1 PROMPT Enter a title up to 30 characters long. 
2 ACCEPT MYTITLE PROMPT 'Title: ° 
3  TTITLE CENTER MYTITLE SKIP 2 
4 SELECT * FROM DEPT 


SQL> SAVE PROMPT1 
Created file PROMPT1 


The TTITLE command sets the top title for your report. This command 
is covered in detail in Chapter 4. 


Finally, run the command file, responding to the prompt for the title as 
shown: 


SQL> START PROMPT1L 
Enter a title up to 30 characters long. 
Title: Department Report as of 1/1/89 


SQL*Plus displays the following output: 


Department Report as of 1/1/89 


DEPTNO DNAME Loc 
10 ACCOUNTING NEW YORK 
20 RESEARCH DALLAS 
30 SALES CHICAGO 
40 OPERATIONS BOSTON 
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Customizing Prompts for 
Substitution Variable 
Values 


Example 3-14 

Using PROMPT and 
ACCEPT in 
Conjunction with 
Substitution Variables 


Before continuing, turn the TTITLE command you entered in the 
command file off as shown below: 


SQL> TTITLE OFF 


If you want to customize the prompt for a substitution variable value, 
use PROMPT and ACCEPT in conjunction with the substitution 
variable, as shown in the following example. 


As you have seen in Example 3-13, SQL*Plus automatically generates a 
prompt for a value when you use a substitution variable. You can 
replace this prompt by including PROMPT and ACCEPT in the 
command file with the query that references the substitution variable. 
To create such a file, enter the commands shown: 


SQL> CLEAR BUFFER 
buffer cleared i iG oh Cw we h 
SQL> INPUT g 

1 PROMPT Enter a valid employee number 


i 
fe 


2 PROMPT For example: 7123, 7456, 7890 

3 ACCEPT ENUMBER NUMBER PROMPT (imp. no.+” 
4 SELECT ENAME, MGR, JOB, SAL 

5 FROM EMP 

6 WHERE EMPNO = &ENUMBER 

7 


SQL> SAVE PROMPT2 
Created file PROMPT2 


Next, run the command file. SQL*Plus prompts for the value of 
ENUMBER using the text you specified with PROMPT and ACCEPT: 


SQL> START PROMPT2 

Enter a valid employee number 
For example: 7123, 7456, 7890 
Emp. Na.: 


Try entering characters instead of numbers to the prompt for "Emp. 
No.": 


Emp. No.: ONE 
"ONE" is not a valid number 
Emp. No.: 
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Sending a Message and 
Accepting [Return] as 
Input 


Clearing the Screen 


Because you specified NUMBER after the variable name in the 
ACCEPT command, SQL*Plus will not accept a non-number value. 
Now enter a number: 


Emp. No.: 7521 
old 3: WHERE EMPNO = &ENUMBER 
new 3: WHERE EMPNO = 7521 


SQL*Plus displays the following output: 


ENAME MGR JOB SALARY 


WARD 7698 SALESMAN $1,250 


If you want to display a message on the user’s screen and then have the 
user enter [Return] after reading the message, use the SQL*Plus 
command PAUSE. For example, you might include the following lines 
in a command file: 


PROMPT Before continuing, make sure you have your account card. 
PAUSE Press RETURN to continue. 


If the message you wish to display fits on one line, you can omit the 
PROMPT command. 


If you want to clear the screen before displaying a report (or at any 
other time), include the SOL*Plus CLEAR command with its SCREEN 
clause at the appropriate point in your command file, in the following 
form: 


CLEAR SCREEN 
Before continuing to the next chapter, reset all columns to their original 
formats and headings by entering the following command: 


SQL> CLEAR COLUMNS 


3-26 SQL*Plus User’s Guide and Reference 


CHAPTER 


FORMATTING QUERY 
RESULTS. 


his chapter explains how to format your query results to produce a 
finished report. This chapter covers the following topics: 


changing column headings 

formatting NUMBER, CHAR, LONG, and DATE columns 
copying, listing, and resetting column display attributes 
suppressing duplicate values and inserting space for clarity 


calculating and printing summary lines (totals, averages, 
minimums, maximums, and more) 

listing and removing spacing and summary line definitions 
setting page dimensions 

placing titles at the top and bottom of each page 

displaying column values and the current date or page number 
in your titles 

listing and suppressing page title definitions 

sending query results to a file or printer 


Read this chapter while sitting at your computer, and try out the 
examples shown. Before beginning, make sure you have access to the 
sample tables described in Chapter 1. 
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Di ranea 
Formatting Columns 


Changing Column 
Headings 


4-2 


Example 4-1 
Changing a Column 
Heading 


Through the SQL*Plus COLUMN command you can change the 
column headings and reformat the column data in your query results. 


SQL*Plus uses column or expression names as default column headings 
when displaying query results. Column names are often short and 
cryptic, however, and expressions can be hard to understand. 


You can define a more useful column heading with the HEADING 
clause of the COLUMN command, in the format shown below: 


COLUMN column_name HEADING column_heading 


To produce a report from EMP with new headings specified for 
DEPTNO, ENAME, and SAL, enter the following commands: 


SQL> COLUMN DEPTNO HEADING Department 
SQL> COLUMN ENAME HEADING Employee 
SQL> COLUMN SAL HEADING Salary 
SQL> COLUMN COMM HEADING Commission 
SQL> SELECT DEPTNO, ENAME, SAL, COMM 
2 FROM EMP 
3 WHERE JOB = 'SALESMAN' ; 


SQL*Plus displays the following output: 


Department Employee Salary Commission 
30 ALLEN 1600 300 
30 WARD 1250 500 
30 MARTIN 1250 1400 
30 TURNER 1500 0 


Note: The new headings will remain in effect until you enter different 
headings, reset each column’s format, or exit from SQL*Plus. 


To change a column heading to two or more words, enclose the new 
heading in single or double quotation marks when you enter the 
COLUMN command. To display a column heading on more than one 
line, use a vertical bar (1) where you want to begin a new line. (You 
can use a character other than a vertical bar by changing the setting of 
the HEADSEP variable of the SET command. See SET in Chapter 6 for 
more information.) 
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Example 4-2 
Splitting a Column 
Heading 


Example 4-3 
Setting the Underline 
Character 


To give the column ENAME the heading EMPLOYEE NAME and to 
split the new heading onto two lines, enter: 


SQL> COLUMN ENAME HEADING ’Employee|Name’ 
Now rerun the query with the slash (/) command: 
SOL> / 


SQL*Plus displays the following output: 


Employee 
Department Name Salary Commission 
30 ALLEN 1600 300 
30 WARD 1250 500 
30 MARTIN 1250 1400 
30 TURNER 1500 0 


To change the character used to underline each column heading, set the 


UNDERLINE variable of the SET command to the desired character. 
To change the character used to underline headings to an equal sign 


and rerun the query, enter the following commands: 


SQL> SET UNDERLINE = 
soL> / 


SQL*Plus displays the following results: 





Employee 
Department Name Salary Commission 
30 ALLEN 1600 300 
30 WARD 1250 500 
30 MARTIN 1250 1400 
30 TURNER 1500 0 


Now change the underline character back to a dash: 
SQL> SET UNDERLINE ’-' 


Note that you must enclose the dash in quotation marks; otherwise 
SQL*Plus interprets the dash as a hyphen indicating you wish to 
continue the command on another line. 
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| 
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Formatting NUMBER 


Columns 


Example 4-4 


Formatting a NUMBER 


Column 


SQL*Plus normally displays numbers with as many digits as are 
required for accuracy, up to a standard display width determined by 
the value of the NUMWIDTH variable of the SET command (normally 
10). You can choose a different format for any NUMBER column by 
using a format model ina COLUMN command. A format model is a 
representation of the way you want the numbers in the column to 
appear, using 9’s to represent digits. 


The COLUMN command identifies the column you want to format and 
the model you want to use, as shown below: 

COLUMN column_name FORMAT model 

Use format models to add commas, dollar signs, angle brackets (around 
negative values), and/or leading zeros to numbers in a given column. 
You can also round the values to a given number of decimal places, 


display minus signs to the right of negative values (instead of to the 
left), and display values in exponential notation. 


To use more than one format model for a single column, combine the 
desired models in one COLUMN command (see Example 4-4). For a 
complete list of format models and further details, see the COLUMN 
command in Chapter 6. 


To display SAL with a dollar sign, a comma, and the numeral zero 
instead of a blank for any zero values, enter the following command: 
SQL> COLUMN SAL FORMAT $99,990 

Now rerun the current query: 

SQL> / 


SQL*Plus displays the following output: 


Employee 
Department Name Salary Commission 
30 ALLEN $1,600 300 
30 WARD $1,250 500 
30 MARTIN $1,250 1400 
30 TURNER $1,500 0 


Use a zero in your format model, as shown above, when you use other 
formats such as a dollar sign and wish to display a zero in place of a 
blank for zero values. 


Note: The format model will stay in effect until you enter a new one, 
reset the column’s format, or exit from SQL*Plus. 
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Formatting CHAR, 
LONG, and DATE 
Columns 


Example 4-5 
Formatting a CHAR 
Column 


SQL*Plus normally displays CHAR values using the width defined for 
the column in the database or width of the column heading, whichever 
is longer. SQL*Plus bases the displayed width of LONG columns on 
the value of the LONG variable of the SET command (normally 80). 
DATE columns not formatted by a SQL TO_CHAR function are 
displayed in SQL*Plus with a default width of 9 characters. For more 
information on formatting DATE columns, see the FORMAT clause of 
the COLUMN command in Chapter 6. 


You can change the displayed width of a CHAR, LONG, or DATE 
column by using the COLUMN command with a format model 
consisting of the letter A (for alphanumeric) followed by a number 
representing the width of the column in characters. 


Within the COLUMN command, identify the column you want to 
format and the model you want to use: 


COLUMN column_name FORMAT model 
If you specify a width shorter than the column heading, SQL*Plus 


truncates the heading. In contrast, NUMBER headings are never 
truncated. 


To set the width of the column ENAME to four characters and rerun 
the current query, enter: 


SQL> COLUMN ENAME FORMAT A4 
SQL> / 


SQL*Plus displays the results: 


Empl 
Department Name Salary Commission 
30 ALLE $1,600 300 
N 
30 WARD $1,250 500 
30 MART $1,250 1400 
IN 
30 TURN $1,500 0 
ER 


Note: The format model will stay in effect until you enter a new one, 
reset the column’s format, or exit from SQL*Plus. 
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Copying Column 
Display Attributes 


4-6 


Example 4-6 
Copying a Column’s 
Display Attributes 


If the WRAP variable of the SET command is set to ON (its default 
value), the employee names wrap to the next line after the fourth 
character, as shown in Example 4-5. If WRAP is set to OFF, the names 
are truncated (cut off) after the fourth character. 


The system variable WRAP controls all columns; you can override the 
setting of WRAP for a given column through the WRAPPED, 
WORD_WRAPPED, and TRUNCATED clauses of the COLUMN 
command. See COLUMN in Chapter 6 for more information on these 
clauses. You will use the WORD_WRAPPED clause of COLUMN later 
in this chapter. 


Note that the column heading is truncated regardless of the setting of 
WRAP or any COLUMN command clauses. 


Now return the column to its previous format: 
SQL> COLUMN ENAME FORMAT A10 


When you want to give more than one column the same display 
attributes, you can reduce the length of the commands you must enter 
by using the LIKE clause of the COLUMN command. The LIKE clause 
tells SQL*Plus to copy the display attributes of a previously defined 
column to the new column, except for changes made by other clauses in 
the same command. 


To give the column COMM the same display attributes you gave to 
SAL, but to specify a different heading, enter the following command: 
SQL> COLUMN COMM LIKE SAL HEADING Bonus 

Rerun the query: 

SQL> / 


SQL*Plus displays the following output: 


Employee 
Department Name Salary Bonus 
30 ALLEN $1,600 $300 
30 WARD $1,250 $500 
30 MARTIN $1,250 $1,400 
30 TURNER $1,500 $0 


SQL*Plus User’s Guide and Reference 


Listing and Resetting 
Column Display 
Attributes 


Example 4-7 
Resetting Column 
Display Attributes to 
their Defaults 


Suppressing and 
Restoring Column 
Display Attributes 


To list the current display attributes for a given column, use the 
COLUMN command followed by the column name only, as shown 
below: 


COLUMN column_name 


To list the current display attributes for all columns, enter the 
COLUMN command with no column names or clauses after it: 

COLUMN 

To reset the display attributes for a column to their default values, use 
the CLEAR clause of the COLUMN command as shown below: 
COLUMN column_name CLEAR 


To reset the attributes for all columns, use the COLUMNS clause of the 
CLEAR command. 


To reset all columns’ display attributes to their default values, enter the 
following command: 

SQL> CLEAR COLUMNS 

columns cleared 

You may wish to place the command CLEAR COLUMNS at the 
beginning of every command file to ensure that previously entered 
COLUMN commands will not affect queries you run in a given file. 


You can suppress and restore the display attributes you have given a 
specific column. To suppress a column’s display attributes, enter a 
COLUMN command in the following form: 


COLUMN column_name OFF 


The OFF clause tells SQL*Plus to use the default display attributes for 
the column, but does not remove the attributes you have defined 
through the COLKJMN command. To restore the attributes you defined 
through COLUMN, use the ON clause: 


COLUMN column_name ON 
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Printing a Line of 
Characters after 


Wrapped Column 
Values 
Example 4-8 
Printing a Line of 
Characters after 
Wrapped Column 
Values 
4-8 


As you have seen, by default SQL*Plus wraps column values to 
additional lines when the value does not fit within the column width. 
If you want to insert a record separator (a line of characters or a blank 
line) after each wrapped line of output (or after every row), use the 
RECSEP and RECSEPCHAR variables of the SET command. 


RECSEP determines when the line of characters is printed: you set 
RECSEP to EACH to print after every line, to WRAPPED to print after 
wrapped lines, and to OFF to suppress printing. The default setting of 
RECSEP is WRAPPED. 


RECSEPCHAR sets the character printed in each line. You can set 
RECSEPCHAR to any character. 


You may wish to wrap whole words to additional lines when a column 
value wraps to additional lines. To do so, use the WORD_WRAPPED 
clause of the COLUMN command as shown below: 


COLUMN column_name WORD WRAPPED 


To print a line of dashes after each wrapped column value, enter the 
following commands: 


SQL> SET RECSEP WRAPPED 
SQL> SET RECSEPCHAR '~' 


Now restrict the width of the column LOC and tell SQL*Plus to wrap 
whole words to additional lines when necessary: 


SQL> COLUMN LOC FORMAT A7 WORD_WRAPPED 


Finally, enter and run the following query: 


SQL> SELECT * FROM DEPT; 


SQL*Plus displays the results: 


DEPTNO DNAME Loc 
10 ACCOUNTING NEW 
YORK 

20 RESEARCH DALLAS 

30 SALES CHICAGO 

40 OPERATIONS BOSTON 


If you set RECSEP to EACH, SQL*Plus prints a line of characters after 
every row (after every department, for the above example). 


Before continuing, set RECSEP to OFF to suppress the printing of 
record separators: 


SQL> SET RECSEP OFF 


SQL*Plus User’s Guide and Reference 


Clarifying Your Report with Spacing and Summary Lines 


When you use an ORDER BY clause in your SQL SELECT command, 
rows with the same value in the ordered column (or expression) are 
displayed together in your output. You can make this output more 
useful to the user by using the SQL*Plus BREAK and COMPUTE 
commands to create subsets of records and add space and/or summary 
lines after each subset. 


The column you specify in a BREAK command is called a break column. 
By including the break column in your ORDER BY clause, you create 
meaningful subsets of records in your output. You can then add 
formatting to the subsets within the same BREAK command, and add a 
summary line (containing totals, averages, and so on) by specifying the 
break column in a COMPUTE command. 


For example, the following query, without BREAK or COMPUTE 
commands, 


SELECT DEPTNO, ENAME, SAL 
FROM EMP 

WHERE SAL < 2500 

ORDER BY DEPTNO; 


produces the following unformatted results: 


DEPTNO ENAME SAL 
10 CLARK 2450 
10 MILLER 1300 
20 SMITH 800 
20 ADAMS 1100 
30 ALLEN 1600 
30 JAMES 950 
30 TURNER 1500 
30 WARD 1250 
30 MARTIN 1250 


To make this report more useful, you would use BREAK to establish 
DEPTNO as the break column. Through BREAK you could suppress 
duplicate values in DEPTNO and place blank lines or begin a new page 
between departments. You could use BREAK in conjunction with 
COMPUTE to calculate and print summary lines containing the total 
(and/or average, maximum, minimum, standard deviation, variance, 
or count of rows of) salary for each department and for all departments. 
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Suppressing Duplicate 
Values in Break 
Columns 


Example 4-9 
Suppressing Duplicate 
Values in a Break 
Column 


Inserting Space when a 
Break Column’s Value 
Changes 


The BREAK command suppresses duplicate values by default in the 
column or expression you name. Thus, to suppress the duplicate 
values in a column specified in an ORDER BY clause, use the BREAK 
command in its simplest form: 


BREAK ON break_column 


Note: Whenever you specify a column or expression ina BREAK 
command, use an ORDER BY clause specifying the same column or 
expression. If you do not do this, the breaks may appear to occur 
randomly. 


To suppress the display of duplicate department numbers in the query 
results shown above, enter the following commands: 


SQL> BREAK ON DEPTNO 

SQL> SELECT DEPTNO, ENAME, SAL 
2 FROM EMP 
3 WHERE SAL < 2500 
4 ORDER BY DEPTNO; 


SQL*Plus displays the following output: 


DEPTNO ENAME SAL 
10 CLARK 2450 
MILLER 1300 

20 SMITH 800 
ADAMS 1100 

30 ALLEN E 1600 
JAMES 950 
TURNER 1500 

WARD 1250 
MARTIN 1250 


You can insert blank lines or begin a new page each time the value 
changes in the break column. To insert n blank lines, use the BREAK 
commard in the following form: 


BREAK ON break_column SKIP n 
To begin a new page, use the command in this form: 


BREAK ON break_column SKIP PAGE 
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Example 4-10 

Inserting Space when a 
Break Column’s Value 
Changes 


Inserting Space after 
Every Row 


Using Multiple 
Spacing Techniques 


Example 4-11 
Combining Spacing 
Techniques 


To place one blank line between departments, enter the following 
command: 


SQL> BREAK ON DEPTNO SKIP 1 


Now rerun the query: 
SOL> / 
SQL*Plus displays the results: 
DEPTNO ENAME SAL 
10 CLARK 2450 
MILLER 1300 
20 SMITH 800 
ADAMS 1100 
30 ALLEN 1600 
JAMES 950 
TURNER 1500 
WARD 1250 
MARTIN 1250 


You may wish to insert blank lines or a page after every row. To skip n 


lines after every row, use BREAK in the following form: 
BREAK ON ROW SKIP n 

To skip a page after every row, use BREAK in this form: 
BREAK ON ROW SKIP PAGE 


Suppose you have more than one column in your ORDER BY clause, 


and wish to insert space when each column’s value changes. Each 


BREAK command you enter replaces the previous one. Thus, if you 
want to use different spacing techniques in one report or insert space 


after the value changes in more than one ordered column, you must 
specify multiple columns and actions in a single BREAK command. 


First, add another column to the current query: 


SQL> L 

1 SELECT DEPTNO, ENAME, SAL 

2 FROM EMP 

3 WHERE SAL < 2500 

4* ORDER BY DEPTNO 
SQL> 1 SELECT DEPTNO, JOB, BNAME, SAL 
SQL> 4 ORDER BY DEPTNO, JOB 
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Now, to skip a page when the value of DEPTNO changes and one line 
when the value of JOB changes, enter the following command: 


SQL> BREAK ON DEPTNO SKIP PAGE ON JOB SKIP 1 


Run the new query to see the results: 








SQL> / 
DEPTNO JOB ENAME SAL 
10 CLERK MILLER 1300 
MANAGER CLARK 2450 
DEPTNO JOB ENAME SAL 
20 CLERK SMITH 800 
ADAMS 1100 
DEPTNO JOB ENAME SAL 
30 CLERK JAMES 950 
SALESMAN ALLEN 1600 
TURNER 1500 
WARD 1250 
MARTIN 1250 


Listing and Removing You can list your current break definition by entering the BREAK 
Break Definitions command with no clauses: 


BREAK 


You can remove the current break definition by entering the CLEAR 
command with the BREAKS clause: 


CLEAR BREAKS 


You may wish to place the command CLEAR BREAKS at the beginning 
of every command file to ensure that previously entered BREAK 
commands will not affect queries you run in a given file. 
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Computing Summary 
Lines when a Break 
Column’s Value 
Changes 


Table 4-1 
Compute Functions 


If you organize the rows of a report into subsets with the BREAK 
command, you can perform various computations on the rows in each 
subset. You do this with the functions of the SQL*Plus COMPUTE 
command. Use the BREAK and COMPUTE commands together in the 
following forms: 


BREAK ON break_column 
COMPUTE function OF column column column ... ON break column 


You can include multiple break columns and actions such as skipping 
lines in the BREAK command, as long as the column you name after 
ON in the COMPUTE command also appears after ON in the BREAK 
command. To include multiple break columns and actions in BREAK 
when using it in conjunction with COMPUTE, use these commands in 
the following forms: 

BREAK ON break_column_1 SKIP PAGE ON break_column_2 SKIP 1 
COMPUTE function OF column column column ... ON break_column_2 


The COMPUTE command has no effect without a corresponding 
BREAK command. 


You can COMPUTE on NUMBER columns, and in certain cases, on all 
types of columns. See COMPUTE in Chapter 6 for details. 


The following table lists compute functions and their effects: 





Function Effect 

SUM Computes the sum of the values in the column. 

MIN Computes the minimum value in the column. 

MAX Computes the maximum value in the column. 

AVG Computes the average of the values in the column. 

STD Computes the standard deviation of the values in 
the column. 

VAR Computes the variance of the values in the column. 

COUNT Computes the number of non-null values in the 
column. 

NUM Computes the number of rows in the column. 


The function you specify in the COMPUTE command applies to all 
columns you enter after OF and before ON. The computed values print 
on a separate line when the value of the ordered column changes. 


All of the COMPUTE functions except NUM ignore null values. 
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Example 4-12 To compute the total of SAL by department, first list the current 
Computing and BREAK definition: 


Printing Subtotals <01> BREAK 


break on DEPTNO skip page nodup 
on JOB skip 1 nodup 


Now enter the following COMPUTE command, and run the current 
query: 

SQL> COMPUTE SUM OF SAL ON DEPTNO 

SQL> / 


SQL*Plus displays the following output: 


DEPTNO JOB ENAME SAL 
10 CLERK MILLER 1300 
MANAGER CLARK 2450 


kkkkkkkkkk IOI aa a 


sum 3750 
DEPTNO JOB ENAME SAL 

20 CLERK SMITH 800 

ADAMS 1100 


FOI IOI OO ee 


sum 1900 
DEPTNO JOB ENAME SAL 

30 CLERK JAMES 950 
SALESMAN ALLEN 1600 

TURNER 1500 

WARD 1250 

MARTIN 1250 

kkkkkkkkkk I Ree net 
sum 6550 


Note that the format of the column SAL controls the appearance of the 
sum of SAL, as well as the individual values of SAL. When you 
establish the format of a NUMBER column, you must allow for the size 
of sums you will include in your report. 
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Computing Summary 
Lines at the End of the 
Report 


Example 4-13 
Computing and 
Printing a Grand Total 


You can calculate and print summary lines based on all values ina 
column by using BREAK and COMPUTE in the following forms: 


BREAK ON REPORT 
COMPUTE function OF column column column ... ON REPORT 


To calculate and print the grand total of salaries for all salesmen, first 
enter the following BREAK and COMPUTE commands: 


SQL> BREAK ON REPORT 
SQL> COMPUTE SUM OF SAL ON REPORT 


Next, enter and run a new query: 


SQL> SELECT ENAME, SAL 
2 FROM EMP 
3 WHERE JOB = ‘SALESMAN’; 


SQL*Plus displays the results: 


ENAME SAL 
ALLEN 1600 
WARD 1250 
MARTIN 1250 
TURNER 1500 
HERMKEEKEEE: Conmnwan. 
sum 5600 


To print a grand total (or grand average, grand maximum, and so on) 
in addition to subtotals (or sub-averages, and so on), include a break 
column and an ON REPORT clause in your BREAK command. Then, 
enter one COMPUTE command for the break column and another to 
compute ON REPORT: 


BREAK ON break_column ON REPORT 
COMPUTE function OF column ON break column 
COMPUTE function OF column ON REPORT 
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Computing Multiple 
Summary Values and 
Lines 


Example 4-14 


Computing the Same 


Type of Summary 
Value on Different 
Columns 


Example 4-15 
Computing Multiple 


Summary Lines on the 


Same Break Column 


You can compute and print the same type of summary value on 
different columns. To do so, enter a separate COMPUTE command for 
each column. 


To print the total of salaries and commissions for all salesmen, first 
enter the following COMPUTE command: 


SQL> COMPUTE SUM OF SAL COMM ON REPORT 


You do not have to enter a BREAK command; the BREAK you entered 
in Example 4-13 is still in effect. Now, add COMM to the current query: 


SQL> 1 SELECT ENAME, SAL, COMM 


Finally, run the revised query to see the results: 


SQL> / 

ENAME SAL COMM 
ALLEN 1600 300 
WARD 1250 500 
MARTIN 1250 1400 
TURNER 1500 (6 
KKEKAKKKER emmm m m m m e m e ee = 
sum 5600 2200 


You can also print multiple summary lines on the same break column. 
To do so, include the function for each summary line in the COMPUTE 
command as follows: 


COMPUTE function function function ... OF column ON break_column 


If you include multiple columns after OF and before ON, COMPUTE 
calculates and prints values for each column you specify. 


To compute the average and sum of salaries for the sales department, 
first enter the following BREAK and COMPUTE commands: 


SQL> BREAK ON DEPTNO 
SQL> COMPUTE AVG SUM OF SAL ON DEPTNO 


Now, enter and run the following query: 


SQL> SELECT DEPTNO, ENAME, SAL 
2 FROM EMP 
3 WHERE DEPTNO = 30 
4 ORDER BY DEPTNO, SAL; 
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Listing and Removing 
COMPUTE Definitions 


Example 4-16 
Removing COMPUTE 
Definitions 


SQL*Plus displays the results: 


DEPTNO ENAME SAL 

30 JAMES 950 

WARD 1250 

MARTIN 1250 

TORNER 1500 

ALLEN 1600 

BLAKE 2850 

HORII e A E E 
avg 1566.66667 
sum 9400 


You can list your current COMPUTE definitions by entering the 
COMPUTE command with no clauses: 


COMPUTE 


You can remove all the COMPUTE definitions by entering the CLEAR 
command with the COMPUTES clause. 


To remove all COMPUTE definitions and the accompanying BREAK 
definition, enter the following commands: 

SQL> CLEAR BREAKS 

breaks cleared 

SQL> CLEAR COMPUTES 

computes cleared 


You may wish to place the commands CLEAR BREAKS and CLEAR 
COMPUTES at the beginning of every command file to ensure that 
previously entered BREAK and COMPUTE commands will not affect 
queries you run in a given file. 
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eee 
Defining Page Titles and Dimensions 


Sett 


ing the Top and 


Bottom Titles 


Table 4-2 


Often-Used Clauses of 


TTITLE and BTITLE 


The word page refers to a screenful of information on your display, or a 
page of a spooled (printed) report. You can place top and bottom titles 
on each page, set the number of lines per page, and determine the 
width of each line. 


As you have already seen, you can set a title to display at the top of 
each page of a report. You can also set a title to display at the bottom of 
each page. The TTITLE command defines the top title; the BTITLE 
command defines the bottom title. 


A TTITLE or BTITLE command consists of the command name TTITLE 
or BTITLE followed by one or more clauses specifying a position or 
format and a CHAR value you wish to place in that position or give 
that format. You can include multiple sets of clauses and CHAR values: 
TTITLE position_clausef{s) char_value position clause (s) 

char_value ... 


or 


BTITLE position_clause(s) char_value position clause (s) 
char_value ... 


The most often used clauses of TTITLE and BTITLE are summarized in 
the following table. For descriptions of all TTITLE and BTITLE clauses, 
see the discussion of TTITLE in Chapter 6. 





Clause Example Description 

COL n coL 72 Makes the next CHAR value 
appear in the specified column of 
the line. 

SKIP n SKIP 2 Skips to a new line n times. If n is 


greater than 1, n-1 blank lines 
appear before the next CHAR 
value. 

LEFT LEFT Left-aligns the following CHAR 
value. 

CENTER CENTER Centers the following CHAR 
value. 

RIGHT RIGHT Right-aligns the following CHAR 
value. 
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Example 4-17 
Placing a Top and 
Bottom Title 


Positioning Title Elements 


Example 4-18 
Positioning Title 
Elements 


To put titles at the top and bottom of each page of a report, enter: 
SQL> TTITLE CENTER ‘ACME WIDGET SALES DEPARTMENT PERSONNEL REPORT’ 


SQL> BTITLE CENTER ‘COMPANY CONFIDENTIAL’ 
Now run the current query: 
sor> / 


SQL*Plus displays the following output: 
ACME WIDGET SALES DEPARTMENT PERSONNEL REPORT 


DEPTNO ENAME SAL 
30 JAMES 950 
30 WARD 1250 
30 MARTIN 1250 
30 TURNER 1500 
30 ALLEN 1600 
30 BLAKE 2850 


COMPANY CONFIDENTIAL 


The report in the preceding exercise might look more attractive if you 
give the company name more emphasis and place the type of report 
and the department name on either end of a separate line. It may also 
help to reduce the linesize and thus center the titles more closely 
around the data. 


You can accomplish these changes by adding some clauses to the 
TTITLE command, and by resetting the system variable LINESIZE, as 
the following example shows. 


To redisplay the personnel report with a repositioned top title, enter the 
following commands: 

SQL> TTITLE CENTER ‘ACME WIDGE SKIP 1 - 

> CENTER seeeesesccecssucese= SKIP 1 LEFT ‘PERSONNEL REPORT! ~ 

> RIGHT ‘SALES DEPARTMENT’ SKIP 2 

SQL> SET LINESIZE 60 

SOL> / 
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Indenting a Title Element 


Exercise 4-19 
Indenting a Title 
Element 


SQL*Plus displays the results: 


PERSONNEL REPORT SALES DEPARTMENT 
DEPTNO ENAME SAL 
30 JAMES 950 
30 WARD 1250 
30 MARTIN 1250 
30 TURNER 1500 
30 ALLEN 1600 
30 BLAKE 2850 


COMPANY CONFIDENTIAL 


The LEFT, RIGHT, and CENTER clauses place the following values at 
the beginning, end, and center of the line. The SKIP clause tells 
SQL*Plus to move down one or more lines. 


Note that there is no longer any space between the last row of the 
results and the bottom title. The last line of the bottom title prints on 
the last line of the page. The amount of space between the last row of 
the report and the bottom title depends on the overall page size, the 
number of lines occupied by the top title, and the number of rows ina 
given page. In the above example the top title occupies three more 
lines than the top title in the previous example. You will learn to set 
the number of lines per page later in this chapter. 


To always print n blank lines before the bottom title, use the SKIP n 
clause at the beginning of the BTITLE command. For example, to skip 
one line before the bottom title in the example above, you could enter 
the following command: 


BTITLE SKIP 1 CENTER 'COMPANY CONFIDENTIAL’ 


You can use the COL clause in TTITLE or BTITLE to indent the title 
element a specific number of spaces. For example, COL 1 places the 
following values in the first character position, and so is equivalent to 
LEFT, or an indent of zero. COL 15 places the title element in the 15th 
character position, indenting it 14 spaces. 


To print the company name left-aligned with the report name indented 
5 spaces on the next line, enter: 


SQL> TTITLE LEFT 'ACME WIDGET’ SKIP 1 ~- 
> COL 6 ‘SALES DEPARTMENT PERSONNEL REPORT’ SKIP 2 
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Entering Long Titles 


Displaying the Page 
Number and other 
System-Maintained 
Values in Titles 


Example 4-20 
Displaying the Current 
Page Number in a Title 


Now rerun the current query to see the results: 


SQL> / 


ACME WIDGET 
SALES DEPARTMENT PERSONNEL REPORT 


DEPTNO ENAME SAL 
30 JAMES 950 
30 WARD 1250 
30 MARTIN 1250 
30 TURNER 1500 
30 ALLEN 1600 
30 BLAKE 2850 


COMPANY CONFIDENTIAL 


If you need to enter a title greater than 500 characters in length, you can 
use the SQL*Plus command DEFINE to place the text of each line of the 
title in a separate user variable: 

SQL> DEFINE LINE1 ‘This is the first line...’ 


SQL> DEFINE LINE2 ‘This is the second line...’ 
SQL> DEFINE LINE3 = ‘This is the third line...’ 


t 


Then, reference the variables in your TTITLE or BTITLE command as 
follows: 


SQL> TTITLE CENTER LINE] SKIP 1 CENTER LINE2 SKIP 1 CENTER LINE3 


You can display the current page number and other system-maintained 
values in your title by entering a system value name as a title element, 
for example: 


TTITLE LEFT system-maintained_value_name 


There are five system-maintained values you can display in titles, the 
most commonly used of which is SQL.PNO (the current page number). 
Refer to the TTITLE command in Chapter 6 for a list of 
system-maintained values you can display in titles. 


To display the current page number at the top of each page, along with 
the company name, enter the following command: 


SQL> TTITLE LEFT ‘ACME WIDGET’ RIGHT 'PAGE:’ SQL.PNO SKIP 2 


Now rerun the current query: 


SQL> / 
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SQL*Plus displays the following results: 


ACME WIDGET PAGE: 1 
DEPTNO ENAME SAL 
30 JAMES 950 
30 WARD 1250 
30 MARTIN 1250 
30 TURNER 1500 
30 ALLEN 1600 
30 BLAKE 2850 


COMPANY CONFIDENTIAL 


Note that SQL.PNO has a format ten spaces wide. You can change this 
format with the FORMAT clause of TTITLE (or BTITLE). 


Example 4-21 To close up the space between the word PAGE: and the page number, 
Formatting a re-enter the TTITLE command as shown: 
System-Maintained 


: SQL> TTITLE LEFT ‘ACME WIDGET’ RIGHT 'PAGE:’ FORMAT 999 - 
Value in a Title 


> SQL.PNO SKIP 2 


Now rerun the query: 


SQL> / 


SQL*Plus displays the following results: 


ACME WIDGET PAGE: 4: 
DEPTNO ENAME SAL 
30 JAMES 950 
30 WARD 1250 
30 MARTIN 1250 
30 TURNER Š 1500 
30 ALLEN 1600 
30 BLAKE 2850 


COMPANY CONFIDENTIAL 
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Listing, Suppressing, 
and Restoring Page 
Title Definitions 


Displaying Column 
Values in Titles 


Example 4-22 
Creating a 
Master/Detail Report 


To list a page title definition, enter the appropriate title command with 
no clauses: 


TTITLE 
BTITLE 


To suppress a title definition, enter: 


TTITLE OFF 
BTITLE OFF 


These commands cause SQL*Plus to cease displaying titles on reports, 
but do not clear the current definitions of the titles. You may restore 
the current definitions by entering: 


TTITLE ON 
BTITLE ON 


You may wish to create a master /detail report that displays a changing 
master column value at the top of each page with the detail query 
results for that value below. You can reference a column value in a top 
title by storing the desired value in a variable and referencing the 
variable in a TTITLE command. Use the following form of the 
COLUMN command to define the variable: 


COLUMN column name NEW_VALUE variable_name 


You must include the master column in an ORDER BY clause and ina 
BREAK command using the SKIP PAGE clause. 


Suppose you want to create a report that displays two different 
managers’ employee numbers, each at the top of a separate page, and 
the people reporting to the manager on the same page as the manager’s 
employee number. First create a variable, MGRVAR, to hold the value 
of the current manager’s employee number: 


SQL> COLUMN MGR NEW_VALUE MGRVAR NOPRINT 
Because you will display the managers’ employee numbers in the title, 


you do not want them to print as part of the detail. The NOPRINT 
clause you entered above tells SQL*Plus not to print the column MGR. 


Next, include a label and the value in your page title, enter the proper 
BREAK command, and suppress the bottom title from the last example: 


SQL> TTITLE LEFT ‘Manager: ’ MGRVAR SKIP 2 
SQL> BREAK ON MGR SKIP PAGE 
SQL> BTITLE OFF 
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Finally, enter and run the following query: 


SQL> SELECT MGR, ENAME, SAL, DEPTNO 
2 FROM EMP 
3 WHERE MGR IN (7698, 7839) 
3 ORDER BY MGR; 


SQL*Plus displays the following output: 


Manager: 7698 

ENAME SAL DEPTNO 
ALLEN 1600 30 
WARD 1250 30 
TURNER 1500 30 
MARTIN 1250 30 
JAMES 950 30 
Manager: 7839 

ENAME SAL DEP TNO 
JONES 2975 20 
BLAKE 2850 30 
CLARK 2450 10 


If you want to print the value of a column at the bottom of the page, 
you can use the COLUMN command in the following form: 


COLUMN column name OLD_VALUE variable name 


SQL*Plus prints the bottom title as part of the process of breaking to a 
new page—after finding the new value for the master column. 
Therefore, if you simply referenced the NEW_VALUE of the master 
column, you would get the value for the next set of detail. 
OLD_VALUE remembers the value of the master column that was in 
effect before the page break began. 
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Displaying the Current You can, of course, date your reports by simply typing a value in the 


Date in Titles 


Setting Page 
Dimensions 


title. This is satisfactory for ad-hoc reports, but if you want to run the 
same report repeatedly, you would probably prefer to have the date 
automatically appear when the report is run. You can do this by 
creating a variable to hold the current date. 


To create the variable (in this example named _DATE), you can add the 
following commands to your SQL*Plus LOGIN file: 

SET TERMOUT OFF 

BREAK ON TODAY 

COLUMN TODAY NEW_VALUE _DATE 

SELECT TO_CHAR(SYSDATE, ‘fmMonth DD, YYYY’) TODAY 

FROM DUAL; 

CLEAR BREAKS 

SET TERMOUT ON 


When you start SQL*Plus, these commands place the value of 
SYSDATE (the current date) into a variable named _DATE. To display 
the current date, you can reference DATE ina title as you would any 
other variable. 


The date format model you include in the SELECT command in your 
LOGIN file determines the format in which SQL*Plus displays the date. 
See your SQL Language Reference Manual or your SQL Language User's 
Guide for more information on date format models. 


You can also enter these commands interactively at the command 
prompt; see COLUMN in Chapter 6 for an example. 


Typically, a page of a report contains a top title, column headings, your 
query results, and a bottom title. SQL*Plus displays a report that is too 
long to fit on one page on several consecutive pages, each with its own 
titles and column headings. The amount of data SQL*Plus displays on 
each page depends on the current page dimensions. 


The default page dimensions used by SQL*Plus are shown below: 


* number of lines before the top title: 1 


* number of lines per page, from the top title to the 
bottom of the page: 14 


* number of characters per line: 80 


You can change these settings to match the size of your computer 
screen or, for printing, the size of a sheet of paper. 
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Example 4-23 
Setting Page 
Dimensions 


You can change the page length with the system variables NEWPAGE 
and PAGESIZE. For example, you may wish to do so when you print a 
report, since printed pages are customarily 66 lines long, not 15 (the 
total number of lines per page is the sum of PAGESIZE and 
NEWPAGE). 


To set the number of lines between the beginning of each page and the 
top title, use the NEWPAGE variable of the SET command: 


SET NEWPAGE number_of_ lines 


If you set NEWPAGE to zero, SQL*Plus skips zero lines and displays 
and prints a formfeed character to begin a new page. On most types of 
computer screens, the formfeed character clears the screen and moves 
the cursor to the beginning of the first line. When you print a report, 
the formfeed character makes the printer move to the top of anew 
sheet of paper, even if the overall page length is less than that of the 


paper. 
To set the number of lines on a page from the top title on, use the 
PAGESIZE variable of the SET command: 


SET PAGESIZE number_of_lines 


You may wish to reduce the linesize to center a title properly over your 
output. Or, you may want to increase linesize for printing on wide 
paper. You can change the line width using the LINESIZE variable of 
the SET command: 


SET LINESIZE number of characters 


To set the page size to 66 lines, clear the screen (or advance the printer 
to a new sheet of paper) at the start of each page, and set the linesize to 
32, enter the following commands: 


SQL> SET PAGESIZE 66 
SQL> SET NEWPAGE 0 
SQL> SET LINESIZE 32 _ 


Now enter and run the following commands to see the results: 


SQL> TTITLE CENTER ‘ACME WIDGET PERSONNEL REPORT’ SKIP 1 - 
> CENTER '10-JAN-89' SKIP 2 
SQL> COLUMN DEPTNO HEADING DEPARTMENT 
SQL> COLUMN ENAME HEADING EMPLOYEE 
SQL> COLUMN SAL FORMAT $99,999 HEADING SALARY 
SQL> SELECT DEPTNO, ENAME, SAL 
2 FROM EMP 
3 ORDER BY DEPTNO; 
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SQL*Plus displays a formfeed followed by the query results: 


ACME WIDGET PERSONNEL REPORT 


DEPARTMENT 


10-JAN-89 


EMPLOYEE 


SALARY 


30 


Now reset PAGESIZE, NEWPAGE, and LINESIZE to their default 


values: 


MILLER 
SMITH 
ADAMS 
FORD 
SCOTT 
JONES 
ALLEN 
BLAKE 
MARTIN 
JAMES 
TURNER 
WARD 


SQL> SET PAGESIZE 14 
SQL> SET NEWPAGE 1 
SQL> SET LINESIZE 80 


To list the current values of these variables, use the SHOW command: 


SQL> SHOW P 
pagesize 14 


AGES I2E 


SQL> SHOW NEWPAGE 


newpage 1 


SQL> SHOW LINESI2E 


linesize 80 
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[es URED SOSA 
Storing and Printing Query Results 


Sending Results to a 
File 


Sending Results toa 
Printer 


Through the SQL*Plus command SPOOL, you can store you query 
results in a file or print them on your computer's default printer. 


To store the results of a query in a file—and still display them on the 
screen—enter the SPOOL command in the following form: 


SPOOL file_name 


SQL*Plus stores all information displayed on the screen after you enter 
the SPOOL command in the file you specify. 


If you do not follow the file name with a period and an extension, 
SPOOL adds a default file extension to the file name to identify it as an 
output file. The default varies with the host operating system; on most 
hosts it is LST or LIS. See the Oracle installation and user’s manual(s) 
provided for your operating system for more information. 


SQL*Plus continues to spool information to the file until you turn 
spooling off, using the following form of SPOOL: 
SPOOL OFF 


Send your query results to a file when you want to edit them with a 
word processor before printing, or include them in a letter, memo, or 
other document. 


To print query results, spool them to a file as described in the previous 
section. Then, instead of using SPOOL OFF, enter the command in the 
following form: 


SPOOL OUT 
SQL*Plus stops spooling and copies the contents of the spooled file to 


your host computer's standard (default) printer. SPOOL OUT does not 
delete the spool file after printing. 
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Example 4-24 
Sending Query Results 
to a Printer 


To generate a final report and spool and print the results, create a 
command file named EMPRPT containing the following commands. 


First, use EDIT to create the command file with your host operating 
system text editor. (Do not use INPUT and SAVE, or SQL*Plus will 
add a slash to the end of the file, and will run the command file twice— 
once as a result of the semicolon and once due to the slash.) 


SQL> EDIT EMPRPT 


Next, enter the following commands into the file, using your text editor: 


SPOOL TEMP 
CLEAR COLUMNS 
CLEAR BREAKS 
CLEAR COMPUTES 


COLUMN DEPTNO HEADING DEPARTMENT 
COLUMN ENAME HEADING EMPLOYEE 
COLUMN SAL HEADING SALARY FORMAT $99, 999 


BREAK ON DEPTNO SKIP 1 ON REPORT 
COMPUTE SUM OF SAL ON DEPTNO 
COMPUTE SUM OF SAL ON REPORT 


SET PAGESIZE 21 
SET NEWPAGE 0 
SET LINESIZE 30 


{TITLE CENTER ‘ACME WIDGET’ SKIP 2 ~ 
LEFT ‘EMPLOYEE REPORT’ RIGHT 'PAGE:’ - 
FORMAT 999 SQL.PNO SKIP 2 


BTITLE CENTER ‘COMPANY CONFIDENTIAL’ 


SELECT DEPTNO, ENAME, SAL 
FROM EMP 
ORDER BY DEPTNO; 


SPOOL OUT 


If you do not want to see the output on your screen, you can also add 
SET TERMOUT OFF to the beginning of the file and SET TERMOUT 
ON to the end of the file. Save the file (you automatically return to 
SQL*Plus). Now, run the command file EMPRPT: 


SQL> @EMPRPT 
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SQL*Plus displays the output on your screen (unless you set 
TERMOUT to OFF), spools it to the file TEMP, and sends the contents 
of TEMP to your default printer: 


ACME WIDGET 


EMPLOYEE REPORT PAGE: 1 
DEPARTMENT EMPLOYEE SALARY 
10 CLARK $2,450 

KING $5,000 

MILLER $1,300 

FOI 
sum $8,750 
20 SMITH $800 

ADAMS $1,100 

FORD $3,000 

SCOTT $3,000 

JONES $2,975 

FOIA 
sum $10,875 


COMPANY CONFIDENTIAL 


ACME WIDGET 





EMPLOYEE REPORT PAGE: 2 
DEPARTMENT EMPLOYEE SALARY 
30 ALLEN $1,600 
BLAKE $2,850 
MARTIN $1,250 
JAMES $900 
TURNER $1,500 
WARD 


FI II II ES 


sum 





FRO Ik am m 


sum $29,025 
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CHAPTER 


ACCESSING 
DATABASES 


his chapter explains how to access databases through SQL*Plus, 
and discusses the following topics: 
* connecting to the default database 
* connecting to a remote database 
e copying data between different databases 
* copying data between tables on the same database 
Read this chapter while sitting at your computer, and try out the 


example shown. Before beginning, make sure you have access to the 
sample tables described in Chapter 1. 
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SRE SR 
Connecting to the Default Database 


In order to access data in a given database, you must first connect to the 
database. When you start SQL*Plus, you normally connect to your 
default ORACLE database, under the username and password you 
enter while starting. Once you have logged on, you can connect under 
a different username with the SQL*Plus CONNECT command. The 
username and password must be valid for the database. 


For example, to connect the username TODD to the default database 
using the password FOX, you could enter: 


SQL> CONNECT TODD/FOX 


If you omit the username and password, SQL*Plus prompts you for 
them. You also have the option of typing only the username following 
CONNECT and omitting the password (SQL*Plus then prompts for the 
password). Because CONNECT first disconnects you from your 
current database, you will be left unconnected to any database if you 
use an invalid username and password in your CONNECT command. 


You can disconnect the username currently connected to ORACLE 
without leaving SQL*Plus by entering the SOL*Plus command 
DISCONNECT at the SQL*Plus command prompt. 


Da dasa ul va UT tia sl 
Connecting to a Remote Database 


5-2 


Many large installations run ORACLE on more than one computer. 
Such computers are often connected in a network, which permits 
programs on different computers to exchange data rapidly and 
efficiently. Networked computers can be physically near each other, or 
can be separated by large distances and connected by 
telecommunication links. 


Databases on other computers or databases on your host computer 
other than your default database are called remote databases. You can 
access remote databases if the desired database has SQL*Net and both 
databases have compatible network drivers. 


You can connect to a remote database in one of two ways: 


+ from within SQL*Plus, using the CONNECT command 
* as you start SQL*Plus, using the SQLPLUS command 
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Connecting toa 
Remote Database from 
within SQL*Plus 


Connecting to a 
Remote Database as 
You Start SQOL*Plus 


To connect to a remote database using CONNECT, include a SQL*Net 
database specification in the CONNECT command in one of the 
following forms (the username and password you enter must be valid 
for the database to which you wish to connect): 


* CONNECT SCOTT@database_specification 


* CONNECT SCOTT/TIGER@database_ specification 


SQL*Plus prompts you for username and password as needed, and 
connects you to the specified database. This database becomes the 
default database until you CONNECT again to another database, 
DISCONNECT, or leave SQL*Plus. 


When you connect to a remote database in this manner, you can use the 
complete range of SQL and SQL*Plus commands and PL/SQL blocks 
on the database. 


The exact string you enter for the database specification depends upon 
the SQL*Net protocol your computer uses. For more information, see 
CONNECT in Chapter 6 and the SQL*Net manual appropriate for your 
protocol, or contact your DBA. 


To connect to a remote database when you start SQL*Plus, include the 
SQL*Net database specification in your SQLPLUS command in one of 
the following forms: 


* SOLPLUS SCOTT@database_ specification 


* SQLPLUS SCOTT/TIGER@database_specification 


You must use a username and password valid for the remote database 
and substitute the appropriate database specification for the remote 
database. SQL*Plus prompts you for username and password as 
needed, starts SQL*Plus, and connects you to the specified database. 
This database becomes the default database until you CONNECT to 
another database, DISCONNECT, or leave SQL*Plus. 


Once again, you can manipulate tables in the remote database directly 
after you connect in this manner. 
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Copying Data from One Database to another 


Understanding COPY 
Command Syntax 


Use the SQL*Plus COPY command to copy data between databases and 
between tables on the same database. With the COPY command, you 
can copy data between databases in the following ways: 


* copy data from a remote database to your local database 


* copy data from your local (default) database to a remote 
database (on most systems) 


* copy data from one remote database to another remote 
database (on most systems) 


You enter the COPY command in the following form: 


COPY FROM database TO database action -~ 
destination_table (column name, column name, column_name ...) - 
USING query 


Here is a sample COPY command: 


COPY FROM SCOTT/TIGER@D:BOSTON-MFG - 
TO TODD/FOX@D:CHICAGO-SALES - 

CREATE NEWDEPT (DNUMBER, DNAME, CITY)- 
USING SELECT * FROM DEPT 


To specify a database in the FROM or TO clause, you must have a valid 
username and password for the local and remote database(s) and know 
the appropriate database specification(s). In place of the database 
specification you can also use a database link name. COPY obeys 
ORACLE security, so that the username you specify must have been 
granted access to tables for you to have access to tables. For 
information on what databases are available to you, contact your DBA. 


When you copy to your local database from a remote database, you can 
omit the TO clause. When you copy to a remote database from your 
local database, you can omit the FROM clause. When you copy 
between remote databases, you must include both clauses. 


The COPY command behaves differently based on whether the 
destination table already exists and on the action clause you enter 
(CREATE in the example above). See "Controlling Treatment of the 
Destination Table" later in this chapter. 


By default, the copied columns have the same names in the destination 
table that they have in the source table. If you want to give new names 
to the columns in the destination table, enter the new names in 
parentheses after the destination table name. If you enter any column 
names, you must enter a name for every column you are copying. 
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Controlling Treatment 
of the Destination 
Table 


The USING clause specifies a query that names the source table and 
specifies the data that COPY copies to the destination table. You can 
use any form of the SOL SELECT command to select the data that the 
COPY command copies. 


Here is an example of a COPY command that copies only two columns 
from the source table, and copies only those rows in which the value of 
DEPTNO is 30: 

SQL> COPY FROM SCOTT/TIGER@D:BOSTON-MEG ~ 

> REPLACE EMPCOPY2 -~ 

> USING SELECT ENAME, SAL - 

> FROM EMPCOPY - 

> WHERE DEPTNO = 30 


You may find it easier to enter and edit long COPY commands in 
command files rather than trying to enter them directly at the 
command prompt. 


You control the treatment of the destination table by entering one of 
four control clauses—-REPLACE, CREATE, INSERT, or APPEND. 


The REPLACE clause names the table to be created in the destination 
database, and specifies the following actions: 
+ If the destination table already exists, COPY drops the existing 
table and replaces it with a table containing the copied data. 
+ If the destination table does not already exist, COPY creates it 
using the copied data. 


You can use the CREATE clause to avoid accidentally writing over an 
existing table. CREATE specifies the following actions: 


+ Ifthe destination table already exists, COPY reports an error 
and stops. 

+ If the destination table does not already exist, COPY creates the 
table using the copied data. 


Use INSERT to insert data into an existing table. INSERT specifies the 
following actions: 
+ Ifthe destination table already exists, COPY inserts the copied 
data in the destination table. 


+ If the destination table does not already exist, COPY reports an 
error and stops. 
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Copying from a Remote 
Database to Your Local 
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Database Using 
CREATE 


Use APPEND when you want to insert data in an existing table, or 
create a new table if the destination table does not exist. APPEND 
specifies the following actions: 


+ If the destination table already exists, COPY inserts the copied 
data in the destination table. 


+ If the table does not already exist, COPY creates the table and 
then inserts the copied data in it. 


To copy EMP from a remote database into a table called EMPCOPY on 
your own database, enter the following command. 


Note: See your DBA for an appropriate username, password, and 
database specification for a remote computer that contains a copy of 
EMP. 


SQL> COPY FROM SCOTT/TIGER@D:BOSTON-MFG ~ 
> CREATE EMPCOPY ~ 
> USING SELECT * FROM EMP 


SQL*Plus displays the following messages: 
Array fetch/bind size is 20. (arraysize is 20) 


Will commit when done. (copycommit is 0) 
Maximum long size is 80. (long is 80) 


SQL*Plus then creates the table EMPCOPY, copies the rows, and 
displays the following additional messages: 


Table EMPCOPY created. 


14 rows selected from SCOTT@D:BOSTON-MFG. 
14 rows inserted into EMPCOPY. 
14 rows committed into EMPCOPY at DEFAULT HOST connection. 


In this COPY command, the FROM clause directs COPY to connect you 
to the database with the specification D:BOSTON-MFG as SCOTT, with 
the password TIGER. 


Notice that you do not need a semicolon at the end of the command; 
COPY is a SQL*Plus command, not a SQL command, even though it 
contains a query. Because most COPY commands are longer than one 
line, you must use a hyphen (-), optionally preceded by a space, at the 
end of each line except the last. 
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Interpreting the 
Messages that COPY 
Displays 


Specifying another 
User's Table 


The first three messages displayed by COPY show the values of SET 
command variables that affect the COPY operation. The most 
important one is LONG, which limits the length of a LONG column’s 
value. (LONG is a datatype, similar to CHAR.) If the source table 
contains a LONG column, COPY truncates values in that column to the 
length specified by the system variable LONG. 


The variable ARRAYSIZE limits the number of rows that SQL*Plus 
fetches from the database at one time. This number of rows makes up a 
batch. The variable COPYCOMMIT sets the number of batches after 
which COPY commits changes to the database. (If you set 
COPYCOMMIT to zero, COPY commits changes only after all batches 
are copied.) For more information on the variables of the SET 
command, including how to change their settings, see SET in Chapter 6. 


After listing the three system variables and their values, COPY tells you 
if a table was dropped, created, or updated during the copy. Then 
COPY lists the number of rows selected, inserted, and committed. 


You can refer to another user’s table in a COPY command by qualifying 
the table name with the username, just as you would in your local 
database, or in a query with a database link. 


For example, to make a local copy of a table named DEPT, owned by 
the username ADAMS on D:BOSTON-MEG, you would enter: 


SQL> COPY FROM SCOTT/TIGER@D:BOSTON-MFG - 
> CREATE EMPCOPY2 - 
> USING SELECT * FROM ADAMS .DEPT 


Of course, you could get the same result by instructing COPY to log on 
to the remote database as ADAMS. You cannot do that, however, 
unless you know the password associated with the username ADAMS. 
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You can copy data from one table to another in a single database (local 
or remote). To copy between tables in your local database, specify your 
own username and password and the database specification for your 
local database in either a FROM or a TO clause (omit the other clause): 


SQL> COPY FROM SCOTT/TIGER@D:MYDATABASE ~ 
> INSERT EMPCOPY2 - 
> USING SELECT * FROM EMP 


To copy between tables on a remote database, include the same 
username, password, and database specification in the FROM and TO 
clauses: 


SQL> COPY FROM SCOTT/TIGER@D:BOSTON-MFG - 
> TO SCOTT/TIGER@D:BOSTON-MFG ~ 

> INSERT EMPCOPY2 -~ 

> USING SELECT * FROM BMP 
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CHAPTER 


COMMAND 
REFERENCE 


his chapter contains descriptions of SQL*Plus commands, listed 
alphabetically. Use this chapter for reference only. Each 
description contains the following parts: 


Purpose Discusses the basic use(s) of the command. 


Syntax Shows how to enter the command. Refer to 
Chapter 1 for an explanation of the syntax notation. 


Terms and Clauses Describes the function of each term or clause 
appearing in the syntax. 


Usage Notes Provides added information on how the command 
works and on uses of the command. 


Examples Gives one or more examples of the command, 


A summary table that lists and briefly describes SQL*Plus commands 
precedes the individual command descriptions. 
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SQL*Plus Command Summary 


Command 


Description 





@ 
/ 


ACCEPT 


APPEND 


BREAK 


BrITLE 


CHANGE 


CLEAR 


COLUMN 


COMPUTE 


CONNECT 


COPY 


DEFINE 


DEL 


DESCRIBE 


DISCONNECT 


EDIT 


6-2 SQL*Plus User's Guide and Reference 


Runs the specified command file. 


Executes the SQL command or PL/SQL block 
currently stored in the SQL buffer. 


Reads a line of input and stores it in a given user 
variable. 


Adds specified text to the end of the current line in 
the buffer. 


Specifies where and how formatting will change in 
a report, or lists the current break definition. 


Places and formats a specified title at the bottom of 
each report page, or lists the current BTITLE 
definition. 

Changes text on the current line in the buffer. 


Resets or erases the current value or setting for the 
specified option, such as BREAKS or COLUMNS. 


Specifies display attributes for a given column. Or, 
lists the current display attributes for a single 
column or for all columns. 


Calculates and prints summary lines, using various 
standard computations, on subsets of selected 
rows. Or, lists all COMPUTE definitions. 


Connects a given username to ORACLE. 


Copies data from a query to a table in a local or 
remote database. 


Specifies a user variable and assigns ita CHAR 
value. Or, lists the value and variable type of a 
single variable or all variables. 


Deletes the current line of the buffer. 


Lists the column definitions for the specified table, 
view, or synonym. 

Commits pending changes to the database and 
logs the current username off ORACLE, but does 
not exit SQL*Plus. 

Invokes a host operating system text editor on the 


contents of the specified file or on the contents of 
the buffer. 





Command 


Description 





EXIT 


GET 


BOST 


INPUT 


LIST 


PAUSE 


PROMPT 


REMARK 


RUN 


RUNFORM 


SAVE 


SET 


SHOW 


SPOOL 


SQLPLUS 


START 


TIMING 


TIITLE 


Commits all pending database changes, terminates 
SQL*Plus, and returns control to the operating 
system. 


Loads a host operating system file into the buffer. 


Executes a host operating system command 
without leaving SQL*Plus. 

Adds one or more new lines after the current line 
in the buffer. 

Lists one or more lines of the buffer. 

Displays an empty line followed by a line 
containing text, then waits for the user to press 
[Return]. Or, displays two empty lines and waits 
for the user’s response. 

Sends the specified message or a blank line to the 
user’s screen. 

Begins a comment in a command file. 


Lists and executes the SQL command or PL/SQL 
block currently stored in the SQL buffer. 


Invokes a SQL*Forms application from within 
SQL*Plus. 

Saves the contents of the buffer in a host operating 
system file (a command file). 

Establishes an aspect of the SQL*Plus environment 
for your current session. 

Lists the value of a SQL*Plus system variable. 


Stores query results in an operating system file 
and, optionally, sends the file to a default printer. 
Also lists the current spooling status. 


Starts SOL*Plus from the operating system prompt. 


Executes the contents of the specified command 
file. 


Records timing data for an elapsed period of time, 
lists the current timing area’s title and timing data, 
or lists the number of active timing areas. 


Places and formats a specified title at the top of 
each report page, or lists the current TTITLE 
definition. 
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Command 


Description 





UNDEF INE 


WHENEVER 
SQLERROR 
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Deletes a given user variable that you defined 
either explicitly (with the DEFINE command) or 
implicitly (with an argument to the START 
command). 


Exits SOL*Plus if a SQL command or PL/SQL 
block generates an error. 


@ (“at" sign) 


Purpose 
Syntax 


Terms and Clauses 


Usage Notes 


Example 


Runs the specified command file. 
@ file_name[.ext] 


Refer to the following list for a description of each term or clause: 


file_name[.ext] Represents the command file you wish to run. If 
you omit ext, SOL*Plus assumes the default 
command-file extension (normally SQL). For 
information on changing the default extension, see 
the SUFFIX variable of the SET command in this 
chapter. 


Note that you can omit the space between the "at" 
sign (@) and the command-file name. 
You can include in a command file any command you would normally 
enter interactively (typically, SQL or SQL*Plus commands). 
The "at" sign command functions similarly to START, but does not 
allow the passing of values to parameters. 
To run a command file named PRINTRPT with the extension SQL, 
enter: 
SQL> @PRINTRPT 
To run a command file named WKRPT with the extension QRY, enter: 


SQL> @WKRPT.ORY 
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/ (slash) 


Purpose 


Syntax 


Usage Notes 


Example 


Executes the SQL command or PL/SQL block currently stored in the 
SQL buffer. 


/ 


You can enter a slash (/) at the command prompt or at a line number 
prompt for a continuing command or block in the SQL buffer. 


The slash command functions similarly to RUN, but does not list the 
command in the buffer on your screen. 


Executing a SQL command or PL/SQL block using the slash command 
will not cause the current line number in the SQL buffer to change 
unless the command in the buffer contains an error. In that case 
SQL*Plus changes the current line number to the number of the line 
containing the error. 


To see the SQL command(s) you will execute, you can list the contents 
of the buffer: 


SQL> LIst 
1* SELECT ENAME, JOB FROM EMP WHERE ENAME = ‘JAMES! 


Enter a slash (/) to the command prompt to execute the command(s) in 
the buffer: 


SQL> / 
For the above query, SQL*Plus displays the following output: 


JAMES CLERK 


6-6 SQL*Plus User’s Guide and Reference 


Purpose 


Syntax 


Terms and Clauses 


Examples 


Reads a line of input and stores it in a given user variable. 


ACC(BPT] variable {NUM[BER] |CHAR} 
[PROMPT text |NOPR(OMPT1} 
[HIDE] 


Refer to the following list for a description of each term or clause: 


variable Represents the name of the variable in which you 
wish to store a value. If variable does not exist, 
SQL*Plus creates it. 

NUM[BER] Restricts the datatype of variable to the datatype 


NUMBER. If the reply does not match the 
datatype, ACCEPT gives an error message and 
terminates. 


CHAR Restricts the datatype of variable to the datatype 
CHAR. If the reply does not match the datatype, 
ACCEPT gives an error message and terminates. 


PROMPT text Displays text on-screen before accepting the value 
of variable from the user. 

NOPRLOMP TI Skips a line and waits for input without 
displaying a prompt. 

BIDE Suppresses the display as you type the reply. 


To display the prompt, "Salary: " and place the reply ina NUMBER 
variable named SALARY, enter: 


SQL> ACCEPT salary NUMBER PROMPT ‘Salary: ' 


To display the prompt, “Password: ", to place the reply ina CHAR 
variable named PSWD, and to suppress the display, enter: 


SQL> ACCEPT pswd CHAR PROMPT ‘Password: ‘' HIDE 
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Purpose 
Syntax 


Terms and Clauses 


Examples 


Adds specified text to the end of the current line in the buffer. 


A[PPEND] text 


Refer to the following list for a description of each term or clause: 


text Represents the text you wish to append. If you 
wish to separate fext from the preceding characters 
with a space, enter two spaces between APPEND 
and text. 


To APPEND fext that ends with a semicolon, end 
the command with two semicolons (SQL*Plus 
interprets a single semicolon as an optional 
command terminator). 


To append a space and the column name DEPT to the second line of the 
buffer, make that line the current line by listing the line as follows: 


SQL> 2 
2* PROM EMP, 


Now enter APPEND: 


SQL> APPEND DEPT 
SQL> 2 
2* FROM EMP, DEPT 


Notice the double space between APPEND and DEPT. The first space 
separates APPEND from the characters to be appended; the second 
space becomes the first appended character. 

To append a semicolon to the line, enter: 

SQL> APPEND ;; 


SQL*Plus appends the first semicolon to the line and interprets the 
second as the terminator for the APPEND command. 


SQL*Plus User’s Guide and Reference 





BREAK 


Purpose 


Syntax 


Terms and Clauses 


Specifies where and how formatting will change in a report, such as: 


+ suppressing display of duplicate values for a given column 
+ skipping a line each time a given column value changes 


+ printing COMPUTEd figures each time a given column value 
changes or at the end of the report (see also the COMPUTE 


command) 


Also lists the current BREAK definition. 


BRE[AK] [ON report_element [action [action]]] ... 


where: 


report_element 


action 


Requires the following syntax: 
{column { expr|ROW|REPORT} 
Requires the following syntax: 


[SKI[P] n| [SKI(P]] PAGE] 
{NODUP ILICATES] | DUP [LICATES] } 


Refer to the following list for a description of each term or clause: 


ON column [action [action]] 


When you include action(s), specifies action(s) for 
SQL*Plus to take whenever a break occurs in the 
specified column (called the break column). A break 
is one of three events: 


» achange in the value of a column or expression 
* the output of a row 
+ the end of a report 


When you omit action(s), BREAK ON column 
suppresses printing of duplicate values in column 
and marks a place in the report where SQL*Plus 
will perform the computation you specify in a 
corresponding COMPUTE command. 


You can specify ON column one or more times. If 
you specify multiple ON clauses, as in 


SQL> BREAK ON DEP TNO SKIP PAGE ON JOB SKIP 1 ~ 
> ON SAL SKIP 1 


the first ON clause represents the outermost break 
(in this case, ON DEPTNO) and the last ON clause 
represents the innermost break (in this case, ON 
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SAL). SQL*Plus searches each row of output for 
the specified break(s), starting with the outermost 
break and proceeding—in the order you enter the 
clauses—to the innermost. In the example, 
SQL*Plus searches for a change in the value of 
DEPTNO, then JOB, then SAL. 


Next, SQL*Plus executes actions beginning with 
the action specified for the innermost break and 
proceeding in reverse order toward the outermost 
break (in this case from SKIP 1 for ON SAL toward 
SKIP PAGE for ON DEPTNO). SQL*Plus executes 
each action up to and including the action 
specified for the first occurring break encountered 
in the initial search. 


If, for example, in a given row the value of JOB 
changes—but the values of DEPTNO and SAL 
remain the same—SQL*Plus skips two lines before 
printing the row (one as a result of SKIP 1 in the 
ON SAL clause and one as a result of SKIP 1 in the 
ON JOB clause). 


Whenever you use ON column, you should also use 
an ORDER BY clause in the SQL SELECT 
command. Typically, the columns used in the 
BREAK command should appear in the same order 
in the ORDER BY clause (although all columns 
specified in the ORDER BY clause need not appear 
in the BREAK command). This prevents breaks 
from occurring at meaningless points in the report. 


With the above BREAK command, the following 
SELECT command produces meaningful results: 


SQL> SELECT DEPTNO, JOB, SAL, ENAME 
2 FROM EMP 
3 ORDER BY DEPTNO, JOB, SAL, ENAME; 


All rows with the same DEPTNO print together on 
one page, and within that page all rows with the 
same JOB print in groups. Within each group of 
jobs, jobs with the same SAL print in groups. 
Breaks in ENAME cause no action, because 
ENAME does not appear in the BREAK command. 


ON expr [action [action}] 
When you include action(s), specifies action(s) for 
SQL*Plus to take when the value of the expression 
changes. 
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l When you omit action(s), BREAK ON expr | 

| suppresses printing of duplicate values of expr and | 

| marks a place in the report where SQL*Plus will | 

| perform the computation you specify in a | 
corresponding COMPUTE command. 


You can use an expression involving one or more 
table columns or an alias assigned to a report f 
column in a SQL SELECT or SQL*Plus COLUMN | 
command. If you use an expression in a BREAK 
command, you must enter expr exactly as it 
appears in the SELECT command. If the 
| expression in the SELECT command is a+b, for 
| example, you cannot use b+a or (a+b) in a BREAK 

command to refer to the expression in the SELECT 
command. 





The information given above for ON column also 
applies to ON expr. 


| ON ROW [action [action]} i 
| When you include action(s), specifies action(s) for | 
| SQL*Plus to take when a SQL SELECT command | 
| returns a row. The ROW break becomes the 

| innermost break regardless of where you specify it | 
| in the BREAK command. You should always i 
| specify an action when you BREAK on a row. | 


| ON REPORT Marks a place in the report where SQL*Plus will 

| perform the computation you specify in a 
corresponding COMPUTE command. Use BREAK 
ON REPORT in conjunction with COMPUTE to 
print grand totals or other "grand" computed 
values. 


| 

| 

The REPORT break becomes the outermost break 

regardless of where you specify it in the BREAK 

| command. 

| 
i 
| 


Refer to the following list for a description of each action: 





SKI[P] n Skips n lines before printing the row where the 
break occurred. 

[SKI[P]] PAGE Skips to a new page before printing the row where 
break occurred. 
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NODUP [LICATES] Prints blanks rather than the value of a break 
column when the value is a duplicate of the 
column’s value in the preceding row. 

DUP [LICATES] Prints the value of a break column in every 
selected row. 


Enter BREAK with no clauses to list the current break definition. 
Usage Notes Each new BREAK command you enter replaces the preceding one. 


Example To produce a report that prints duplicate job values, prints the average 
of SAL and inserts one blank line when the value of JOB changes, and 
additionally prints the sum of SAL and inserts another blank line when 
the value of DEPTNO changes, you could enter the following 
commands. (The example selects departments 10 and 30 and the jobs of 
clerk and salesman only.) 


SQL> BREAK ON DEPTNO SKIP 1 ON JOB SKIP 1 DUPLICATES 
SQL> COMPUTE SUM OF SAL ON DEPTNO 
SQL> COMPUTE AVG OF SAL ON JOB 
SQL> SELECT DEPTNO, JOB, BNAME, SAL FROM EMP 
2 WHERE JOB IN (‘CLERK', ‘SALESMAN’ ) 
3 AND DEPTNO IN (10, 30) 
4 ORDER BY DEPTNO, JOB; 


The following output results: 


DEP TNO JOB ENAME SAL 
10 CLERK MILLER 1300 
WHEREERON eee 

avg f 1300 

CETTE TTET 
sum 1300 
30 CLERK JAMES 1045 
FOI ee 

avg 1045 

SALESMAN ALLEN 1760 

SALESMAN MARTIN 1375 

SALESMAN TURNER 1650 

SALESMAN WARD 1375 

KIRK re en aw ow mm on ow a 

avg 1540 

RW i ia nt it 
sum 7205 
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BTITLE 


Purpose 


Syntax 


Terms and Clauses 


Usage Notes 


Examples 


Places and formats a specified title at the bottom of each report page, or 
list the current BTITLE definition. 


Note: Fora description of the old form of BTITLE, see BTITLE (old 
form) in Appendix F. 


BTI(TLE] [printspec [text|variable] ...] | 
[OFF | ON] 


Refer to the TTITLE command for additional information on terms and 
clauses in the BTITLE command syntax. 


Enter BTITLE with no clauses to list the current BTITLE definition. 


SQL*Plus interprets BTITLE in the new form if a valid printspec clause 
(LEFT, SKIP, COL, etc) immediately follows the command name. 


For information on printing page numbers in the title, see TTITLE. 


To set a bottom title with CORPORATE PLANNING DEPARTMENT 
on the left and a date on the right, enter: 


SQL> BTITLE LEFT ‘CORPORATE PLANNING DEPARTMENT’ - 
> RIGHT '11 Mar 1988’ 


To set a bottom title with CONFIDENTIAL in column 50, followed by 6 
spaces and a date, enter: 


SQL> BTITLE COL 50 ‘CONFIDENTIAL’ TAB 6 ‘11 Mar 88 
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Purpose 
Syntax 


Terms and Clauses 


Usage Notes 


Changes text on the current line in the buffer. 
C[HANGE] sepchar old [sepchar [new {sepchar}]] 


Refer to the following list for a description of each term or clause: 


sepchar Represents any non-alphanumeric character such 
as"/" or "I". Use a sepchar that does not appear in 
old or new. You can omit the space between 
CHANGE and the first sepchar. 


old Represents the text you wish to change. CHANGE 
ignores case in searching for old. For example, 


CHANGE /aq/aw 


will find the first occurrence of "aq", "AQ", "aQ", or 
"Aq" and change it to "aw". SQL*Plus inserts the 
new text exactly as you specify it. 


If old is prefixed with "...", it matches everything up 
to and including the first occurrence of old. If it is 
suffixed with "...", it matches the first occurrence of 
old and everything that follows on that line. Ifit 
contains an embedded "...", it matches everything 
from the preceding part of old through the 
following part of old. 

new Represents the text with which you wish to replace 
old. If you omit new and, optionally, the second 
and third sepchars, CHANGE deletes old from the 
current line of the buffer. 


CHANGE changes the existing text you specify from the current line of 
the buffer to the new text you specify. The current line is marked with 
an asterisk (*) in the LIST output. 


You can also use CHANGE to modify a line in the buffer that has 
generated an ORACLE error. SQL*Plus sets the buffer’s current line to 
the line containing the error so that you can make modifications. 


To re-enter an entire line, you can type the line number followed by the 
new contents of the line. If you specify a line number larger than the 
number of lines in the buffer, and follow the number with text, 
SQL*Plus adds the text in a new line at the end of the buffer. If you 
specify zero ("0") for the line number and follow the zero with text, then 
SQL*Plus inserts the line at the beginning of the buffer (that line 
becomes line 1). 
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Examples 


Assume the current line of the buffer contains the following text: 
4* WHERE JOB IS IN ('CLERK’,' SECRETARY’ , ‘RECEPTIONIST’ ) 
Enter the following command: 

SQL> C /RECEPTIONIST/GUARD/ 

The text in the buffer changes as follows: 

4* WHERE JOB IS IN (/ CLERK’, SECRETARY’, ‘GUARD') 

Or enter the following command: 

SQL> C /'CLERK',...//CLERK’) / 

The original line changes to: 

4* WHERE JOB IS IN (‘CLERK’) 

Or enter the following command: 

SQL> C /(...)/ (1 COOK! , ‘BUTLER’ ) / 

The original line changes to: 

4* WHERE JOB IS IN ('COOK’,’ BUTLER’) 


You can replace the contents of an entire line using the line number. 
This entry 


SQL> 2 FROM EMP el 
causes the second line of the buffer to be replaced with: 


FROM EMP el 


Note: Entering a line number followed by a string will replace the line 
regardless of what text follows the line number. Thus, 


SQL> 2 c/old/new/ 


will change the second line of the buffer to be: 
SQL> c/old/new 
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Purpose Resets or erases the current value or setting for the specified option. 


Syntax CL[EAR] option 


where option represents one of the following clauses: 


BRE [AKS 
BUFF [ER 
COL [UMNS] 
COMP [UTES] 
SCR [EEN 
SOL 

TIMI {NG 


Terms and Clauses Refer to the following list for a description of each term or clause: 


BRE [AKS 





BUFF [ER 


COL [UMNS] 


COMP (UTES} 


SCR[EEN) 


SQL 


TIMI[NG] 


Removes the break definition set by the BREAK 
command. 


Clears text from the buffer. CLEAR BUFFER has 
the same effect as CLEAR SQL, unless you are 
using multiple buffers (see SET BUFFER in 
Appendix F). 

Resets column display attributes set by the 
COLUMN command to default settings for all 
columns. To reset display attributes for a single 
column, use the CLEAR clause of the COLUMN 
command. 

Removes all COMPUTE definitions set by the 
COMPUTE command. 


Clears your screen. 


Clears the text from SQL buffer. CLEAR SQL has 
the same effect as CLEAR BUFFER, unless you are 
using multiple buffers (see SET BUFFER in 
Appendix F). 


Deletes all timing areas created by the TIMING 
command, 


Examples To clear breaks, enter: 


SQL> CLEAR BREAKS 


To clear column definitions, enter: 


SQL> CLEAR COLUMNS 
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TA] 
COLUMN 


Purpose 


Syntax 


Terms and Clauses 


Specifies display attributes for a given column, such as: 


+ text for the column heading 

+ alignment of the column heading 
+ format for NUMBER data 

* wrapping of column data 


Also lists the current display attributes for a single column or all 
columns. 


COL{[UMN] [{columnlexpr} [option ...]] 


where option represents one of the following clauses: 


ALI([AS] alias 

CLE [AR] |DEF [AULT] 

COLOR {color|color_variable} 

FOLD_A(PTER] n 

FOLD_B[{EFORE] n 

FOR(MAT] format 

HEA(DING] text 

JUS{TIFY] (L(EFT) |C (ENTER) |C[ENTRE] [R([IGHT] } 
LIKE {exprlalias) 

LINEAPP {LINE |MARK|BOTH} 

NEWL [INE 
NEW_V[ALUE] variable 
NOPRI{NT} [PRI [NT] 
NUL[L] char 
OLD_V[ALUE}] variable 
ON | OFF 
PATTERN (pattern_number|pattern_variable} 
WRA [PPED] | WOR [D_WRAPPED] | TRU [NCATED] 








Enter COLUMN followed by column or expr and no other clauses to list 
the current display attributes for only the specified column or 
expression. Enter COLUMN with no clauses to list all current column 
display attributes. 
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Refer to the following list for a description of each term or clause: 


{column | expr} 


ALI [AS] alias 


CLE [AR 


Identifies the data item (typically, the name of a 
column) in a SQL SELECT command to which the 
column command refers. If you use an expression 
in a COLUMN command, you must enter expr 
exactly as it appears in the SELECT command. If 
the expression in the SELECT command is a+b, for 
example, you cannot use b+a or (a+b) ina 
COLUMN command to refer to the expression in 
the SELECT command. 


If you select columns with the same name from 
different tables, a COLUMN command for that 
column name will apply to both columns. That is, 
a COLUMN command for the column ENAME 
applies to all columns named ENAME that you 
reference in this session. COLUMN ignores table 
name prefixes in SELECT commands. 


To format the columns differently, assign a unique 
alias to each column within the SELECT command 
itself (do not use the ALIAS clause of the 
COLUMN command) and enter a COLUMN 
command for each column’s alias. 


Assigns a specified alias to a column, which can be 
used to refer to the column in BREAK, COMPUTE, 
and other COLUMN commands. 


Resets the display attributes for the column to 
default values. 


COLOR {color|color variable} 


FOLD_A(FTER] n 





FOLD_B[EFORE] n 
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Is described in the SQL*Graph User's Guide. 


Inserts a carriage return after the column heading 
and after each row in the column. You must enter 
n; the particular value you choose for n has no 
effect on the format. 


Inserts a carriage return before the column heading 
and before each row of the column. You must 
enter n; the particular value you choose for n has 
no effect on the format. FOLD_BEFORE has the 
same effect as NEWLINE. 


FOR[MAT] format 


Specifies the display format of the column. The 
format specification must be a text constant such as 
A10 or $9,999—not a variable. 


A CHAR column’s width defaults to the column's 
width as defined in the database or to the length of 
the column’s heading, whichever is longer. A 
LONG column’s width defaults to the value of SET 
LONG. To change the width of a CHAR or LONG 
column to n, use FORMAT An. If you specify a 
width shorter than the column heading, SQL*Plus 
truncates the heading. 


SQL*Plus formats CHAR data left-justified. Ifa 
value does not fit within the column width, 
SQL*Plus wraps or truncates the character string 
depending on the setting of SET WRAP. 


The default width for unformatted DATE columns 
in SQL*Plus is A9. To change the format of a 
DATE column, use the SQL function TO_CHAR in 
your SQL SELECT command. 


When you use TO_LCHAR, ORACLE automatically 
allows for a very wide column, so SQL*Plus 
automatically sets the column width to 80 
characters. You must then use the SQL*Plus 
COLUMN command to reset the width of the 
column. To change the width of a DATE column 
ton, use FORMAT An. If you specify a width 
shorter than the column heading, SOL*Plus 
truncates the heading. For more information on 
TO_CHAR, see your SQL Language User's Guide 
and your SQL Language Reference Manual. 


Note: Other SQL calculations may cause a similar 
effect; in that case use the SQL*Plus COLUMN 
command to reset the column width. 


A NUMBER column’s width defaults to the value 
of SET NUMWIDTH. To change the width, use 
FORMAT followed by an element as specified in 
Table 6-1, on the following page. 
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TABLE 6-1 Element Example(s) Description 








Number Formats 

9 9999 Determines the display width by 
the number of digits entered. 

0 0999 Displays leading zeroes. 

9990 Displays zero instead of a blank 
when a value is zero. 

$ $9999 Prefixes a dollar sign to a value. 

B B9999 Displays a zero value as blank. 

MI 9999MI Displays "-" after a negative value. 

PR 9999PR Displays a negative value in angle 
brackets. 

comma 9,999 Displays a comma in the position 
indicated. 

period 99.99 Aligns the decimal point in the 
position indicated. 

Vv 999V99 Multiplies value by 10n, where n 
is the number of "9’s" after the "V." 

EEEE 9. 999EEEE Displays in scientific notation 
(format must contain exactly four 
"E’s"), 

DATE DATE Displays value as a date in 
MM/DD/YY format; used to 
format NUMBER columns that 
represent Julian dates. 


SQL*Plus formats NUMBER data right-justified. 

The field width equals the width of the heading or 

the format plus one space for the sign, whichever 

is greater. SQL*Plus never truncates a NUMBER 

column heading. If a value does not fit within the 

column width, SQL*Plus displays an asterisk (*) in 

place of each digit the width allows to indicate | 
overflow. j 
With all number formats, SQL*Plus rounds a ! 
number to the specified number of significant 

digits. When no format is given, a number's width 

defaults to the value of NUMWIDTH (see the SET 
command in this chapter). 
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HBA[DING] text 


Defines a column heading. If you do not use a 
HEADING clause, the column’s heading defaults 
to column or expr. If text contains blanks or 
punctuation characters, you must enclose it with 
single or double quotes. Each occurrence of the 
HEADSEP character (by default,’ |’) begins a new 
line. For example, 


COLUMN ENAME HEADING ‘Employee |Name’ 


would produce a two-line column heading. See 
the HEADSEP variable of the SET command in this 
chapter for information on changing the 
HEADSEP character. 


JUS[TIFY} {L[EFT] [CENTER] {CENTRE} |R[IGHT) } 


LIKE {expr|alias} 


Aligns the heading. If you do not use a JUSTIFY 
clause, NUMBER columns default to RIGHT and 
other column types default to LEFT. 


Copies the display attributes of another column or 
expression (whose attributes you have already 
defined with another COLUMN command). LIKE 
copies only attributes not defined by another 
clause in the current COLUMN command. 


LINEAPP {LINE |MARK |BOTH} 


NEWL [INE] 


Is described in the SQL*Graph User's Guide. 


Starts a new line before displaying the column’s 
value. NEWLINE has the same effect as 
FOLD_BEFORE n. 


NEW_V(ALUE] variable 


Specifies a variable to hold a column value. You 
can reference the variable in TTITLE commands. 
Use NEW_VALUE to display column values or the 
date in the top title. You must include the column 
in a BREAK command with the SKIP PAGE action. 


NEW_VALUE is useful for master /detail reports 
in which there is anew master record for each 
page. For master/detail reporting, you must also 
include the column in the ORDER BY clause. See 
the example at the end of this command 
description. 


For information on displaying a column value in 
the bottom title, see COLUMN OLD_VALUE. 
Refer to TTITLE for more information on 
referencing variables in titles. See COLUMN 
FORMAT for details on formatting and valid 
format models. 
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NOPRI [NT] IPRIINT] Controls the printing of the column (the column 


NUL[L] char 


heading and all the selected values). NOPRINT 
turns the printing of the column off. PRINT turns 
the printing of the column on. 


Controls the text SQL*Plus displays for null values 
in the given column. If you do not use a NULL 
clause in the COLUMN command, SQL*Plus 
displays blanks—or the text to which you have set 
NULL using the SET command—whenever a null 
value is encountered in the given column. (SET 
NULL controls the text displayed for all null 
values for all columns, unless overridden for a 
specific column by the NULL clause of the 
COLUMN command.) 


OLD_V[ALUE] variable 


ON | OFF 


Specifies a variable to hold a column value. You 
can reference the variable in BTITLE commands. 
Use OLD_VALUE to display column values or the 
date in the bottom title. You must include the 
column in a BREAK command with the SKIP 
PAGE action. 


OLD_VALUE is useful for master/detail reports in 
which there is a new master record for each page. 
For master/detail reporting, you must also include 
the column in the ORDER BY clause. 


For information on displaying a column value in 
the top title, see COLUMN NEW_VALUE. Refer 
to TTITLE for more information on referencing 
variables in titles. See COLUMN FORMAT for 
details on formatting and valid format models. 


Controls the status of display attributes for a 
column. OFF disables the attributes for a column 
without affecting the attributes’ definition. ON 
reinstates the attributes. 


PATTERN {pattern_number|pattern_variable} 


Is described in the SQL*Graph User's Guide. 


WRALPPED}| WOR[D_WRAPPED] | TRU (NCATED] 
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Specifies how SQL*Plus will treat a CHAR string 
that is too wide for a column. WRAPPED wraps 
the end of the string to the next line. 
WORD_WRAP functions similarly to WRAPPED, 
but moves an entire word to the next line rather 
than splitting the word between two lines. 
TRUNCATED truncates the string at the end of the 
first line of display. 





Usage Notes 


Examples 


You can enter any number of COLUMN commands for one or more 
columns. All column attributes set for each column remain in effect for 
the remainder of the session, or until you turn the column OFF. Thus, 
the COLUMN commands you enter can control a column’s display 
attributes for multiple SOL SELECT commands. 


When you enter multiple COLUMN commands for the same column, 
SQL*Plus applies their clauses collectively. If several COLUMN 
commands apply the same clause to the same column, the last one 
entered will control the output. 


To make the ENAME column 20 characters wide and display 
EMPLOYEE NAME on two lines at the top, enter: 


SQL> COLUMN ENAME FORMAT A20 HEADING ‘EMPLOYEE | NAME‘ 
To format the SAL column so that it shows millions of dollars, rounds 


to cents, uses commas to separate thousands, and displays $0.00 when 
a value is zero, you would enter: 


SQL> COLUMN SAL FORMAT $9,999, 990.99 
To assign the alias NET to a column containing a long expression, to 


display the result in a dollar format, and to display <NULL> for null 
values, you might enter: 

SQL> COLUMN SAL+COMM+BONUS-EXPENSES-INS-TAX ALIAS NET 

SQL> COLUMN NET FORMAT $9,999,999.99 NULL ‘<NULL>’ 


Note that the example divides this column specification into two 
commands. The first defines the alias NET, and the second uses NET to 
define the format. 


Also note that in the first command you must enter the expression 
exactly as you entered it (or will enter it) in the SELECT command. 
Otherwise, SQL*Plus cannot match the COLUMN command to the 
appropriate column. 

To wrap long values in a column named REMARKS, you can enter: 


SQL> COLUMN REMARKS FORMAT A20 WRAP 


For example: 

CUSTOMER DATE QUANTITY REMARKS 

123 25~AUG-86 144 This order must be s 
hipped by air freigh 
t to ORD. 
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If you replace WRAP with WORD_WRAP, REMARKS looks like this: 


CUSTOMER DATE QUANTITY REMARKS 


123 25-AUG-86 144 This order must be 
shipped by air 
freight to ORD. 


If you specify TRUNCATE, REMARKS looks like this: 


CUSTOMER DATE QUANTITY REMARKS 


123 25~-AUG-86 144 This order must be s 


In order to print the current date and the name of each job in the top 
title, enter the following. (For details on creating a date variable 
through your SQL*Plus LOGIN file, see "Displaying the Current Date 
in Titles” under "Defining Page Titles and Dimensions" in Chapter 4.) 


SQL> COLUMN JOB NOPRINT NEW_VALUE JOBVAR 
SQL> COLUMN TODAY NOPRINT NEW_VALUE DATEVAR 
SQL> BREAK ON JOB SKIP PAGE ON TODAY 
SQL> TTITLE CENTER ‘Job Report’ RIGHT DATEVAR SKIP 2 ~ 
> LEFT 'Job: ’ JOBVAR SKIP 2 
SQL> SELECT TO_CHAR(SYSDATE, ‘MM/DD/YY’) TODAY, 
2 ENAME, JOB, MGR, HIREDATE, SAL, DEPTNO 
3 FROM EMP WHERE JOB IN (’CLERK’, ‘SALESMAN‘) 
4 ORDER BY JOB, ENAME; 


Your 2-page report would look similar to the following report, with 
"Job Report" centered within your current linesize: 


Job Report 05/01/88 
Job: CLERK 
ENAME MGR HIREDATE SAL DEPTNO 
ADAMS 7788 14-JAN-87 1100 20 
JAMES 7698 03-DEC-81 950 30 
MILLER 7782 23-JAN-82 1300 10 
SMITH 7902 17-DEC-80 800 20 
Job Report 05/01/88 
Job SALESMAN 
ENAME MGR HIREDATE SAL DEPTNO 
ALLEN 7698 20-PEB-81 1600 30 
MARTIN 7698 28-SEP-81 1250 30 
TURNER 7698 08-SEP-81 1500 30 
WARD 7698 22-FEB-81 1250 30 


SQL*Plus User’s Guide and Reference 








COMPUTE 


Purpose 


Syntax 


Terms and Clauses 


TABLE 6-2 
COMPUTE Functions 


Calculates and prints summary lines, using various standard 
computations, on subsets of selected rows. Or, lists all COMPUTE 


definitions. 


COMP [UTE] 


[function ... 
OF {expr|column|alias}... 
ON {expr|column|alias{REPORT|ROW}] 


Refer to the following list for a description of each term or clause: 





function ... Represents one of the functions listed in Table 6-2, 
below: 
Function Computes Applies to Datatypes 
AVG Average of non-null values NUMBER 
COU [NT] Count of non-null values all types 
MAX [IMUM] Maximum value NUMBER, CHAR 
MIN [IMUM} Minimum value NUMBER, CHAR 
NUM[BER] Count of rows all types 
STD Standard deviation of NUMBER 
non-null values 
SUM Sum of non-null values NUMBER 
VAR [IANCE] Variance of non-null values NUMBER 
If you specify more than one function, use spaces 
to separate the functions. 
OF {expr|column|alias}... 





Specifies the column(s) or expression(s) you wish 
to use in the computation. You must also specify 
these columns in the SQL SELECT command, or 
SQL*Plus will ignore the COMPUTE command. 


If you do not want the computed values of a given 
column to appear in the output of a SELECT 
command, specify that column in a COLUMN 
command with a NOPRINT clause. Use spaces to 
separate multiple expressions, columns, or aliases 
within the OF clause. 


To reference a SELECT expression or function 
reference in an OF clause, place the expression or 
function reference in quotes. Column names and 
aliases do not need quotes. 
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ON {expricolumn|alias|REPORT{ROW}] 
Specifies the event SQL*Plus will use as a break. 
COMPUTE prints the computed value and restarts 
the computation when the event occurs (i.e., when 
the value of the expression changes, a new ROW is 
fetched, or the end of the report is reached). 


If multiple COMPUTE commands reference the 
same column in the ON clause, only the last 
COMPUTE command applies. 


To reference a SQL SELECT expression or function 
reference in an ON clause, place the expression or 
function reference in quotes. Column names and 
aliases do not need quotes. 


Enter COMPUTE without clauses to list all COMPUTE definitions. 


Usage Notes In order for the computations to occur, the following must all be true: 


+ The expression, column, or column alias you reference in the 
ON clause must occur in the SELECT command. 

+ The expression, column, or column alias you reference in the 
ON clause must also occur in the most recent BREAK 
command. 

+ If you reference either ROW or REPORT in the ON clause, also 
reference ROW or REPORT in the most recent BREAK 
command, 


* One or more of the expressions, columns, or column aliases 
you reference in the OF clause must also occur in the SELECT 
command. 
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Examples To subtotal the salary for the "clerk," "analyst," and "salesman" job 
classifications, enter: 


SQL> BREAK ON JOB SKIP 1 
SQL> COMPUTE SUM OP SAL ON JOB 
SQL> SELECT JOB, ENAME, SAL 
i 2 PROM EMP 
3 WHERE JOB IN (/CLERK’, ‘ANALYST’, ‘SALESMAN*) i 
| 4 ORDER BY JOB, SAL; | 
| 


The following output results: 





JOB ENAME SAL 
Fai Rat ed crm al tai, Cladia a ne | 
| ANALYST SCOTT 3000 f 
| FORD 3000 | 
TORII IR ee te re, | 
| 
sum 6000 | 
CLERK SMITH 800 
JAMES 950 
ADAMS 1100 | 
MILLER 1300 | 
HRI RRR IK oe re 0 i 
sum 4150 | 
i 
SALESMAN WARD 1250 | 
MARTIN 1250 | 
TURNER 1500 
ALLEN 1600 
WILSON 3000 
WRI RII ca te et 
sum 8600 








| 
| 
| 
| 
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To compute the average and maximum salary for the accounting and 
sales departments, enter: 


SQL> BREAK ON DNAME SKIP 1 
SQL> COMPUTE AVG MAX OF SAL ON DNAME 
SQL> SELECT DNAME, ENAME, SAL 
2 FROM DEPT, EMP 
3 WHERE DEPT.DEPTNO=EMP .DEPTNO 
4 AND DNAME IN (* ACCOUNTING’, 'SALES’) 
5 ORDER BY DNAME; 


The following output results: 


DNAME ENAME SAL 
ACCOUNTING CLARK 2450 
KING 5000 
MILLER 1300 
FOO III ee 
avg 2916.66667 
maximum 5000 
SALES ALLEN 1600 
WARD 1250 
MARTIN 1250 
TURNER 1500 
JAMES 950 
BLAKE 2850 
FOTO ee 
avg 1566.66667 
maximum 2850 
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CONNECT 


Purpose 


Syntax 


Terms and Clauses 


Connects a given username to ORACLE. 


CONN[ECT] [logon] 


where: 
logon Requires the following syntax: 


username[/password] (@database specification] | 


/ 


Refer to the following list for a description of each term or clause: 


username [/password] 
Represent the username and password with which 
you wish to connect to ORACLE. If you omit 
username and password, SQL*Plus prompts you for 
them. If you enter a slash (/) or simply enter 
[Return] to the prompt for username, SQL*Plus logs 
you on using a default logon (see "/" below). 


If you omit only password, SQL*Plus prompts you 
for password. When prompting, SQL*Plus does not 
display password on your terminal screen. 


Represents a default (ops$) logon. You cannot 
enter a database_specification if you use a default 
logon. Ina default logon SQL*Plus attempts to log 
you on using the username OPS$name, where name 
is your operating system username. 


database specification 
Consists of a SQL*Net connection string. The exact 
syntax depends upon the SQL*Net 
communications protocol your Oracle installation 
uses. For more information, refer to the SQL*Net 
manual appropriate for your protocol or contact 
your DBA. SQL*Plus does not prompt for a 
database specification, but uses your default 
database if you do not include a specification. 
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Usage Notes CONNECT commits the current transaction to the database, 
disconnects the current username from ORACLE, and reconnects with 
the specified username. 


Examples To connect using username SCOTT and password TIGER to the default 
database on the DECnet node "corp", enter: 


SQL> CONNECT SCOTT/TIGER@d:corp 


To connect using username SCOTT and let SQL*Plus prompt you for 
the password, enter: 


SQL> CONNECT SCOTT 
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Purpose Copies the data from a query to a table in a local or remote database. 


Syntax COPY [FROM username[/password] [@database_speci fication] | 
TO username[/password] [@database_specification])] 
{APPEND | CREATE | INSERT | REPLACE } destination_table [ (column, 
column, column ...)} USING query 


Terms and Clauses Refer to the following list for a description of each term or clause: 


username [/password] 
Represent the ORACLE username/password you 
wish to COPY FROM and TO. In the FROM 
clause, username/password identifies the source of 
the data; in the TO clause, username/password 
identifies the destination. If you do not specify 
password in either the FROM clause or the TO 
clause, SQL*Plus will prompt you for it. SQL*Plus 
suppresses the display of your response to these 
prompts. 


database_specification 
Consists of a database link name or SQL*Net 
connection string. In the FROM clause, 
database_specification represents the database at the 
source; in the TO clause, database_specification 
represents the database at the destination. The 
exact syntax depends upon the SQL*Net 
communications protocol your Oracle installation 
uses. For more information, refer to the SQL*Net 
manual appropriate for your protocol or contact 
your DBA. SQL*Plus does not prompt for a 
database specification, but uses your default 
database if you do not include a specification. 


destination_table Represents the table you wish to create or to which 
you wish to add data. 


(column, column, column, ...) 
Specifies the names of the columns in 
destination_table. You must enclose a name in 
double quotes if it contains lower case letters or 
blanks. 


If you specify columns, the number of columns 
must equal the number of columns selected by the 
query. If you do not specify any columns, the 
copied columns will have the same names in the 
destination table as they had in the source, if COPY 
creates destination_table. 
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Usage Notes 


USING query Specifies a SQL query (SELECT command) 
determining which rows and columns COPY 
copies. 

FROM username [/password] [@database_specification] 

Specifies the username, password, and database 
that contains the data to be copied. If you omit the 
FROM clause, the source defaults to the database 
SQL*Plus is connected to (i.e., the database that 
other commands address). You must include a 
FROM clause to specify a source database other 
than the default. 


TO username [/password] [@database_specification] 
Specifies the database containing the destination 
table. If you omit the TO clause, the destination. 
defaults to the database SQL*Plus is connected to 
(i.e., the database that other commands address). 
You must include a TO clause to specify a 
destination database other than the default. 


APPEND Inserts the rows from query into destination_table if 
the table exists. If destination_table does not exist, 
COPY creates it. 

CREATE Inserts the rows from query into destination_table 


after creating the table first. If destination_table 
already exists, COPY returns an error. 


INSERT Inserts the rows from query into destination_table if 
the table exists. If destination_table does not exist, 
COPY returns an error. 

REPLACE Deletes existing rows from destination_table and 


inserts the rows from query into destination_table if 
the table exists. If destination_table does not exist, 
COPY creates it. 


The SQL*Plus SET variable LONG limits the length of LONG columns 
that you copy. If any LONG columns contain data longer than the 
value of LONG, COPY truncates the data. 


SQL*Plus performs a commit at the end of each successful COPY. If 
you set the SQL*Plus SET variable COPYCOMMIT to a positive value 
n, SQL*Plus performs a commit after copying every n batches of 
records. (The SQL*Plus SET variable ARRAYSIZE determines the size 
of the batch.) 
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Examples 


The following command copies the entire EMP table from database HQ 
to a table named WESTEMP in database WEST. If WESTEMP already 
exists, SQL*Plus replaces its contents. The columns in WESTEMP have 
the same names as the columns in the source table, EMP. 


SQL> COPY FROM SCOTT/TIGER@HQ TO JOHN/CHROME@WEST - 
> REPLACE WESTEMP - 
> USING SELECT * FROM EMP 


The following command copies selected records from EMP in database 
HQ to the database to which SQL*Plus is connected. SQL*Plus creates 
SALESMEN through the copy. SQL*Plus copies only the columns 
EMPNO and ENAME and at the destination names them EMPNO and 
SALESMAN. 

SQL> COPY FROM SCOTT/TIGER@HQ - 

> CREATE SALESMEN (EMPNO, SALESMAN) - 

> USING SELECT EMPNO, ENAME FROM EMP - 

> WHERE JOB=! SALESMAN’ 
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Purpose 


Syntax 


Terms and Clauses 


Usage Notes 


Specifies a user variable and assigns it a CHAR value. Or, lists the 
value and variable type of a single variable or all variables. 


DEF [INE] [variable] | 
{variable = text] 


Refer to the following list for a description of each term or clause: 


variable Represents the user variable whose value you wish 
to assign or list. 

text Represents the CHAR value you wish to assign to 
variable. Enclose text in single quotes if it contains 
punctuation or blanks. 


variable = text Defines (names) a user variable and assigns ita 
CHAR value. 

Enter DEFINE followed by variable to list the value and type of variable. 

Enter DEFINE with no clauses to list the values and types of all user 

variables. 


DEFINEd variables retain their values until one of the following events 
occurs: 


+ you enter a new DEFINE command referencing the variable 

+ you enter an UNDEFINE command referencing the variable 

+ you enter an ACCEPT command referencing the variable 

* you reference the variable in the NEW_VALUE or 
OLD_VALUE clause of the COLUMN command and reference 
the column in a subsequent SQL SELECT command 

+ you EXIT SQL*Plus 


Whenever you run a stored query or command file, SQL*Plus 
substitutes the value of variable for each substitution variable 
referencing variable (in the form &variable or &&variable). SQL*Plus will 
not prompt you for the value of variable in this session until you 
UNDEFINE variable. 


You can DEFINE a maximum of 240 variables. 


Note that you can use DEFINE to define the variable, EDITOR, which 
establishes the host system editor invoked by the SQL*Plus EDIT 
command. 
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| Examples 
| 
| 
| 
| 





If you continue the value of a DEFINEd variable on multiple lines 
(using the SQL*Plus command continuation character), SQL"Plus 
replaces each continuation character and carriage return you enter with 
a space in the resulting variable. For example, SQL*Plus interprets 


SQL> DEFINE TEXT = ‘ONE- 
> TWO- 
> THREES 


as: 
SQL> DEFINE TEXT = ‘ONE TWO THREE’ 

To assign the value MANAGER to the variable POS, type: 
SQL> DEFINE POS = MANAGER 


If you execute a command that contains a reference to &POS, SQL*Plus 
will substitute the value MANAGER for &POS and will not prompt 
you for a POS value. 


To assign the CHAR value 20 to the variable DEPTNO, type: 


SQL> DEFINE DEPTNO = 20 


Even though you enter the number 20, SQL*Plus assigns a CHAR value 
to DEPTNO consisting of two characters, 2 and 0. 


To list the definition of DEPTNO, enter: 


SQL> DEFINE DEPTNO 
DEFINE DEPTNO = "20" (CHAR) 


This result shows that the value of DEPTNO is 20. 
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DEL 


Purpose Deletes the current line of the buffer. 


Syntax DEL 


Usage Notes DEL makes the following line of the buffer (if any) the current line. To 
delete several consecutive lines, enter DEL several times. 


Examples Assume the SQL buffer contains the following query: 


1 SELECT ENAME, DEPTNO 
2 FROM EMP 

3 WHERE JOB = ‘SALESMAN’ 
4* ORDER BY DEPTNO 


To make the line containing the WHERE clause the current line, you 
would enter: 


SQL> LIST 3 
3* WHERE JOB = ‘SALESMAN’ 


To delete the WHERE clause, enter: 
SQL> DEL 


The SQL buffer now contains the following lines: 


1 SELECT ENAME, DEPTNO 
2 FROM EMP 
3* ORDER BY DEPTNO 
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DESCRIBE 


Purpose 
Syntax 


Terms and Clauses 


Usage Notes 


Example 


Lists the column definitions for the specified table, view, or synonym. 
DESC[RIBE] [user.] object [@database_link_name] 


Refer to the following list for a description of each term or clause: 


user Represents the user who owns object. If you omit 
user, SQL*Plus assumes you own object. 
object Represents the table, view, or synonym whose 


column definitions you wish to list. 


database_link_name 
Consists of the database link name corresponding 
to the database where object exists. For more 
information on database links, refer to the SQL 
Language User's Guide and the SQL Language 
Reference Manual. 


The description contains the following information: 


* each column’s name 


+ whether or not null values are allowed (NULL or NOT NULL) 
for each column 


+ datatype of the column 


* precision of the column (and scale, if any, for a numeric 
column) 


To describe the table EMP, enter: 
SQL> DESCRIBE EMP 


DESCRIBE lists the following information: 


Name Null? Type 

EMPNO NOT NULL NUMBER (4) 
ENAME CHAR (10) 
JOB JOB (9) 

MGR NUMBER (4) 
BIREDATE DATE 

SAL NUMBER (7, 2) 
COMM NUMBER (7,2) 
DEPTNO NUMBER {2) 
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DISCONNECT 


Purpose 


Syntax 


Usage Notes 


Example 


Commits pending changes to the database and logs the current 
username off ORACLE, but does not exit SOL*Plus. 


DISC {ONNECT] 


Use DISCONNECT within a command file to prevent user access to the 
database when you want to log the user off ORACLE but have the user 
remain in SQL*Plus. Use EXIT or QUIT to log off ORACLE and return 
control to your host computer’s operating system. 


Your command file might begin with a CONNECT command and end 
with a DISCONNECT, as shown below. 


SQL> GET MYFILE 
1 CONNECT ... 


15* DISCONNECT 
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EDIT 


Purpose 


Syntax 


Terms and Clauses 


Usage Notes 


Example 


Invokes a host operating system text editor on the contents of the 
specified file or on the contents of the buffer. 


EDIT [file name[.ext)}] 


Refer to the following list for a description of each term or clause: 

file_name{.ext] Represents the file you wish to edit (typically a 
command file). If you omit ext, SQL*Plus assumes 
the default command-file extension (normally 
SQL). For information on changing the default 
extension, see the SUFFIX variable of the SET 
command in this chapter. 


Enter EDIT with no file name to edit the contents of the SQL buffer 
with the host operating system text editor. 


The user variable, EDITOR, contains the name of the text editor 
invoked by EDIT. You can change the text editor by changing the 
value of EDITOR. See DEFINE for information about changing the 
value of a user variable. If EDITOR is undefined, EDIT attempts to 
invoke the default host operating system editor. 


EDIT alone places the contents of the buffer in a file named AFIEDT 
with the extension BUF (located in your current working directory) and 
invokes the text editor on the contents of the file. When you tell the 
editor to save edited text, the text is saved back into the buffer. EDIT 
returns an error message if you do not specify a file name and the 
buffer is empty. 

To leave the editing session and return to SQL*Plus, terminate the 
editing session in the way customary for the text editor. 


To edit the file REPORT with the extension SQL using your host 
operating system text editor, enter: 


SQL> EDIT REPORT 
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Purpose 


Syntax 


Terms and Clauses 


Usage Notes 


Example 


Commits all pending database changes, terminates SQL*Plus, and 
returns control to the operating system. 


{EXIT{QUIT} [SUCCESS |FPAILURE | WARNING |n| variable} 


Refer to the following list for a description of each term or clause: 


{EXIT |QUIT) Can be used interchangeably (QUIT is a synonym 
for EXIT). 

n Represents an integer you specify as the return 
code. 

variable Represents a user-defined or system variable, such 


as SQL.SQLCODE. EXIT variable exits with the 
value of variable as the return code. 


SUCCESS Exits normally. 
FAILURE Exits with a return code indicating failure. 
WARNING Exits with a return code indicating warning. 


EXIT with no clauses exits with a value of SUCCESS. 


EXIT allows you to specify an operating system return code. This 
allows you to run SQL*Plus command files in batch mode and to detect 
programmatically the occurrence of an unexpected event, The manner 
of detection is operating system specific. See the Oracle installation and 
user’s manual(s) provided for your operating system for details. 


The key words SUCCESS, WARNING, and FAILURE represent 
operating-system dependent values. On some systems, WARNING 
and FAILURE may be indistinguishable. 


Note: SUCCESS, FAILURE, and WARNING are not reserved words. 
For information on exiting conditionally, see the WHENEVER 
SQLERROR command later in this chapter. 

The following returns the error code of the last executed SQL command 
or PL/SQL block: 

SQL> EXIT SQL.SQLCODE 

The location of the return code depends on your system. Consult your 


DBA for information concerning how your operating system retrieves 
data from a program. 
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Purpose 
Syntax 


Terms and Clauses 


Example 


Loads a host operating system file into the buffer. 
GET file _name[.ext] [LISIT) |NOL{IST]] 


Refer to the following list for a description of each term or clause: 


file_name{.ext] Represents the file you wish to load (typically a 
command file). If you do not specify a file 
extension, SQL*Plus assumes the default 
command-file extension (normally SQL). For 
information on changing the default extension, see 
the SUFFIX variable of the SET command in this 


chapter. 
LISIT Lists the contents of the file. 
NOL [IST] Suppresses the listing. 


To load a file called YEARENDRPT with the extension SQL into the 
buffer, type: 


SQL> GET YEARENDRPT 
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HOST 
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Purpose 
Syntax 


Terms and Clauses 


Usage Notes 


Example 


Executes a host operating system command without leaving SQL*Plus. 
HO[ST] [command] 


Refer to the following list for a description of each term or clause: 
command Represents a host operating system command. 


Enter HOST without command to display an operating system prompt. 
You can then enter multiple operating system commands. For 
information on returning to SQL*Plus, refer to the Oracle installation 
and user's manual(s) provided for your operating system. 


With some operating systems, you can use a "$" or another character 
instead of HOST. See the Oracle installation and user’s manual(s) 
provided for your operating system for details. 


You may not have access to the HOST command, depending on your 
operating system. See the Oracle installation and user's manual(s) 
provided for your operating system or ask your DBA for more 
information. 


To execute an operating system command, ls *.sql, enter: 


SQL> HOST ls *.sql 
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EA 
INPUT 


Purpose 
Syntax 


Terms and Clauses 


Usage Notes 


Examples 


Adds one or more new lines of text after the current line in the buffer. 


I{NPUT] {text} 


Refer to the following list for a description of each term or clause: 

text Represents the text you wish to add. To adda 
single line, enter the text of the line after the 
command INPUT, separating the text from the 
command with a space. To begin the line with one 
or more spaces, enter two or more spaces between 
INPUT and the first non-blank character of text. 


To add several lines, enter INPUT with no text. INPUT prompts you 
for each line. To leave INPUT, enter a null (empty) line. 


If you enter at the command prompt a line number larger than the 
number of lines in the buffer, and follow the number with text, 
SQL*Plus adds the text in a new line at the end of the buffer. If you 
specify zero (0) for the line number and follow the zero with text, then 
SQL*Plus inserts the line at the beginning of the buffer (that line 
becomes line 1). 


Assume the SQL buffer contains the following command: 
1 SELECT ENAME, DEPTNO, SAL, COMM 

2 FROM EMP 

To add an ORDER BY clause to the query, enter: 


SQL> LIST 2 
2* FROM EMP 
SQL> INPUT ORDER BY ENAME 


LIST 2 ensures that line 2 is the current line. INPUT adds a new line 
containing the ORDER BY clause after the current line. The SQL buffer 
now contains the following lines: 

1 SELECT ENAME, DEPTNO, SAL, COMM 

2 FROM EMP 

3* ORDER BY ENAME 
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To add a two-line WHERE clause, enter: 


SQL> LIST 2 
2* FROM EMP 
SQL> INPUT 
3 WHERE JOB = ‘SALESMAN’ 
4 AND COMM 500 
5 


INPUT prompts you for new lines until you enter an empty line. The 
SQL buffer now contains the following lines: 


SELECT ENAME, DEPTNO, SAL, COMM 
FROM EMP 

WHERE JOB = ‘SALESMAN’ 

AND COMM 500 

ORDER BY ENAME 


OAenenr 
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aE 
LIST 


Purpose 
Syntax 


Terms and Clauses 


Usage Notes 


Example 


Lists one or more lines of the buffer. 


L[IST] (nln min *(n LAST|*{* n|* LAST|LAST] 


Refer to the following list for a description of each term or clause: 


n Lists line n. 

nm Lists lines n through m. 

n* Lists line # through the current line. 

n LAST Lists line n through the last line. 

* Lists the current line. 

*n Lists the current line through line n. 

* LAST Lists the current line through the last line. 
LAST Lists the last line. 


Enter LIST with no clauses to list all lines. 


You can omit the space between LIST and n or *, but not between LIST 


and LAST. 

The last line listed becomes the new current line (marked by an 
asterisk). 

To list the contents of the buffer, enter: 

SQL> L 


You will see a listing of all lines in the buffer, similar in form to the 


following: 


1 SELECT ENAME, DEPTNO, JOB 
2 FROM EMP 

3 WHERE JOB = ‘CLERK’ 

4* ORDER BY DEPTNO 


The asterisk indicates that line 4 is the current line. 
To list the second line only, enter: 

SQL> L 2 

You will then see this: 


2* FROM EMP 
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To list the current line (now line 2) to the last line, enter: 


SQL> L * LAST 


You will then see this: 


2 FROM EMP 
3 WHERE JOB = ‘CLERK’ 
4* ORDER BY DEPTNO 
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PAUSE 


Purpose 


Syntax 


Terms and Clauses 


Usage Notes 


Example 


Displays an empty line followed by a line containing text, then waits 
for the user to press [Return]. Or, displays two empty lines and waits 
for the user's response. 


PAU[SE} [text] 


Refer to the following list for a description of each clause or term: 
text Represents the text you wish to display. 


Enter PAUSE followed by no text to display two empty lines. 


Because PAUSE always waits for the user’s response, it is best to use a 
message that tells the user explicitly to press [Return]. 


PAUSE reads input from the terminal (if a terminal is available) even 
when you have designated the source of the command input asa file. 


For information on pausing between pages of a report, see the PAUSE 
variable of the SET command later in this chapter. 


To print "Adjust paper and press RETURN to continue.", and to have 
SQL*Plus wait for the user to press [Return], you might include the 
following PAUSE command in a command file: 


SQL> GET MYFILE 

1 SET PAUSE OFF 

2 PAUSE Adjust paper and press RETURN to continue. 
3 SELECT ... 
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Purpose 
Syntax 


Terms and Clauses 


Usage Notes 


Example 


Sends the specified message or a blank line to the user’s screen. 
PROMPT [text] 


Refer to the following list for a description of each term or clause: 


text Represents the text of the message you wish to 
display. If you omit text, PROMPT displays a 
blank line on the user’s screen. 


You can use this command in command files to give information to the 
user. 


The following example shows the use of PROMPT in conjunction with 
ACCEPT ina command file called ASKFORDEPT. ASKFORDEPT 
contains the following SQL*Plus and SQL commands: 


PROMPT 

PROMPT Please enter a valid department 
PROMPT For example: 10, 20, 30, 40 
ACCEPT NEWDEPT NUMBER PROMPT ‘DEPT:> / 
SELECT DNAME FROM DEPT 

WHERE DEPTNO = &NEWDEPT 


Assume you run the file using START or @: 


SQL> @ASKFORDEPT 


SQL*Plus displays the following prompts: 


Please enter a valid department 
For example: 10, 20, 30, 40 
DEPT:> 


The end user enters a department number to the prompt DEPT:>. 
SQL*Plus lists the line containing &NEWDEPT before and after 
substitution, and then displays the department name corresponding to 
the number entered at the DEPT:> prompt. 
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REMARK 


Purpose 
Syntax 


Usage Notes 


Example 


Begins a comment in a command file. 


REM [ARK] 


The REMARK command must appear at the beginning of a line, and 
the comment ends at the end of the line (a line cannot contain botha 
comment and a command). SQL*Plus does not interpret the comment 


as a command. 


For information on entering comments in command files using the SQL 
comment delimiters, /* ...*/, refer to the subsection "Placing 
Comments in Command Files" under "Saving Commands for Later 
Use" in Chapter 3. 


The following command file contains some typical comments: 


SQL> GET EMPSUM 


1 REM COMPUTE uses BREAK ON REPORT to break on end of table. 
2 BREAK ON REPORT 

3 COMPUTE SUM OF "DEPARTMENT 10" "DEPARTMENT 20" - 

4 “DEPARTMENT 30" "TOTAL BY JOB" ON REPORT 

5 REM Each column displays the sums of salaries by job for 

6 REM one of the departments 10, 20, 30. 

7 SELECT JOB, 

8 SUM( DECODE { DEPTNO, 10, SAL, 0)) “DEPARTMENT 10", 
9 SUM( DECODE ( DEPTNO, 20, SAL, 0)) "DEPARTMENT 20", 
10 SUM( DECODE( DEPTNO, 30, SAL, 0)) "DEPARTMENT 30", 
il SUM(SAL) "TOTAL BY JOB" 

12 FROM EMP 


13* GROUP BY JOB 
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RUN 


Purpose Lists and executes the SQL command or PL/SQL block currently stored 
in the SQL buffer. 


Syntax R{UN] 


Usage Notes RUN causes the last line of the SQL buffer to become the current line. 
The slash command (/) functions similarly to RUN, but does not list 
the command in the SQL buffer on your screen. 


Example Assume the SQL buffer contains the following query: 
SELECT DEPTNO FROM DEPT 


To RUN the query, enter: 


SQL> RUN 


The following output results: 
1* SELECT DEPTNO FROM DEPT 


DEP TNO 
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Do 
RUNFORM 


Purpose 


Syntax 


Usage Notes 


Example 


Invokes a SQL*Forms application from within SQL*Plus. 


Note: You have access to this command only if your site chose this 
option while installing SQL*Plus. 


RUNFORM [options] form_name 


The RUNFORM syntax is the same in both SQL*Plus and SQL*Forms. 
If you are already in SQL*Plus, you can invoke a form more quickly in 
this manner than by invoking a form from the system prompt, because 
you avoid a separate ORACLE logon. See your SQL*Forms Operator's 
Guide for details on the correct syntax. 


Note that when you use RUNFORM from within SQL*Plus, you may 
not specify a username/ password (you retain your current connection 
to ORACLE). If you wish to use a different username/ password, use 
the SQL*Plus CONNECT command to connect to the desired ORACLE 
username prior to issuing the RUNFORM command. 


To run a form named MYFORM, enter: 


SQL> RUNFORM MYFORM 
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Purpose 


Syntax 


Terms and Clauses 


Usage Notes 


Example 


Saves the contents of the buffer in a host operating system file (a 
command file). 


SAV[E] file_name[.ext] (CRELATE]|REP [LACE] | APP [END} ] 


Refer to the following list for a description of each term or clause: 


file_name[.ext] Specifies the command file in which you wish to 
save the buffer’s contents. If you do not specify an 
extension, SOL*Plus assumes the default 
command-file extension (normally SQL). For 
information on changing this default extension, see 
the SUFFIX variable of the SET command in this 
chapter. 


If you wish to SAVE a file under a name identical 
toa SAVE command clause (CREATE, REPLACE, 
or APPEND), you must specify a file extension. 


CRELATE1 Creates the file if the file does not exist. 

REP [LACE] Replaces the contents of an existing file. If the file 
does not exist, REPLACE creates the file. 

APP [END] Adds the contents of the buffer to the end of the 
file you specify. 


When you SAVE the contents of the SQL buffer, SAVE adds a line 
containing a slash (/) to the end of the file. 


To save the contents of the buffer in a file named DEPTSALRPT with 
the extension SQL, enter: 


SQL> SAVE DEPTSALRPT 


To save the contents of the buffer in a file named DEPTSALRPT with 
the extension OLD, enter: 


SQL> SAVE DEPTSALRPT.OLD 
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Purpose 


Syntax 


Establishes an aspect of the SQL*Plus environment for your current 


session, such as: 
* setting the display width for NUMBER data 
* setting the display width for LONG data 
« enabling or disabling the printing of column headings 
e setting the number of lines per page 


SET system_variable value 


where system _variable value represents a system variable followed by a 


value as shown below: 


ARRAY [SIZE] {20|n 
AUTO[COMMIT] {OFF {ON | IMM[EDIATE] } 
BLO{[CKTERMINATOR] {lc} 

CMDS[EP] {;|c{OFF|ON} 
COM(PATIBILITY) {V5|V6} 

CON([CAT] {.|c/OFF]ON)} 
COPYC[OMMIT] {OQ|n} 
CRI crt 
DEF [INE] {&|c{OFF|ON} 
ECHO {OFF ]ON} 
EMBEDDED (OFF |ON} 
ESC[APE] (\|clOFFION} 
FEED [BACK] {6|]n|OFF|ON} 
FLU([SH)] {OFF/ON} 
HEA(DING] {OFF |ON 
HEADS [EP] {| }clOFF|ON} 
LIN{ESIZE] {80|n) 
LONG {80|n} 
MAXD [ATA] n 
NEWP (AGE) (1{n} 
NULL text 
NUME [ORMAT] format 

NUM[WIDTH] (10]}n} 

PAGES [IZE] {14in} 

PAU[SE] {OFF ION] text} 

RECSEP {WR[APPED] |EA(CH] |OPF} 
RECSEPCHAR {_{c} 

SCAN {OFF ON) 

SHOW(MODE] {OFF |ON} 

SPA[CE] {lIn} 

SQLC[ASE] (MIX[ED] |LO[WER] | UP [PER] } 
SQLCO[NTINUE] {>_| text) 

SQLN [UMBER] {OFF {ON} 
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Terms and Clauses 


SQLPRE(FIX] {#1¢} 

SQLP [ROMPT] {SQL>| text} 
SQLT(ERMINATOR] {:{clOFF|ON} | 
SUF(FIX] {SQL|text} 

TAB {OFF |ON} 

TERM[OUT] {OFF |ON} 
TI(ME} (QFP/ON} 
TIMI{NG] {OFF|ON} 
TRIM{OUT] {OFF |ON} 
UND[ERLINE] {=|¢]ON|OPF} 
VER(IFY] {OFF {ON} 

WRA(P] {OFF |ON} 


Refer to the following list for a description of each term, clause, or 
system variable: 





ARRAY [SIZE] (20/n} Sets the number of rows—called a batch—that 
SQL*Plus will fetch from the database at one time. 
Valid values are 1 to 5000. A large value increases 
the efficiency of queries and subqueries that fetch 
many rows, but requires more main memory in the 
host computer. Values over approximately 100 
provide little added performance. ARRAYSIZE 
has no effect on the results of SQL*Plus operations 
other than increasing efficiency. 


AUTO[COMMIT] {QFF|ON|IMM[EDIATE] } 
Controls when ORACLE commits pending 
changes to the database. ON commits pending 
changes to the database after ORACLE executes 
each SQL command or PL/SQL block. OFF 
suppresses automatic committing, so that you 
must commit changes manually (for example, with 
the SQL command COMMIT). IMMEDIATE 
functions in the same manner as the ON option. 


BLO[CKTERMINATOR] {1c} 
Sets the non-alphanumeric character used to end 
PL/SQL blocks to c. To execute the block, you 
must issue a RUN or / (slash) command. 


CMDS[EP] {;|clOFE|ON} 
Sets the non-alphanumeric character used to 
separate multiple SQL*Plus commands entered on 
one line to c. ON or OFF controls whether you can 
enter multiple commands on a line; ON 
automatically sets the command separator 
character to a semicolon (;). 
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COM[PATIBILITY] {V51N&6) 


Controls whether SQL*Plus stores the COMMIT 
and ROLLBACK commands in the SQL buffer. V5 
does not store COMMIT and ROLLBACK in the 
SQL buffer; V6 does. Set COMPATIBILITY to V5 if 
you wish to run a command file created with 
Version 5 of ORACLE; set the variable to V6 if you 
wish to run a command file created with Version 6 
of ORACLE, 


Refer to the SQL Language Reference Manual for 
information on COMMIT and ROLLBACK. 


CON{CAT] {.1¢clOFF JON) 


COPYC[OMMIT] {Qin} 


CRT ert 


Sets the character you can use to terminate a 
substitution variable reference if you wish to 
immediately follow the variable with a character 
that SQL*Plus would otherwise interpret as a part 
of the substitution variable name. SQL*Plus resets 
the value of CONCAT to a period when you 
switch CONCAT on. 


Controls the number of batches after which the 
COPY command commits changes to the database. 
COPY commits rows to the destination database 
each time it copies n row batches. Valid values are 
0 to 5000. You can set the size of a batch with the 
ARRAYSIZE variable. If you set COPYCOMMIT 
to 0, COPY performs a commit only at the end of a 
copy operation. 

Changes the default CRT file used in the SQL*Plus 
RUNFORM command. To return to the original 
default (before CRT was set), set CRT to nothing 
by entering two double quotes ("") for crt. 


If you want to use NEW.CRT during a form 
invocation on a system where the default CRT is 
OLD.CRT, you can either invoke the form by: 


SQL> RUNFORM ~c NEW form_name 
or 


SQL> SET CRT NEW 
SQL> RUNFORM form_name 


The second method stores the CRT option so that 
you do not need to re-specify it for subsequent 
RUNFORM commands during the same SQL*Plus 
session. 
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DEF[INE] {&{clOFF QN} 


ECHO {OFF |ON} 


EMBEDDED (OFE{ON} 


Sets the character used to prefix substitution 
variables to c. ON or OFF controls whether 
SQL*Plus will scan commands for substitution 
variables and replace them with their values. The 
setting of DEFINE to ON or OFF overrides the 
setting of the SCAN variable. 


Controls whether the START command lists each 
command in a command file as the command is 
executed. ON lists the commands; OFF suppresses 
the listing. 

Controls where on a page each report begins. OFF 
forces each report to start at the top of a new page. 
ON allows a report to begin anywhere on a page. 
Set EMBEDDED to ON when you want a report to 
begin printing immediately following the end of 
the previously run report. 


ESC[APE] {\|clOFF|ON} 


Defines the character you enter as the escape 
character. OFF undefines the escape character. 
ON enables the escape character. 


You can use the escape character before the 
substitution character (set through SET DEFINE) 
to indicate that SQL*Plus should treat the 
substitution character as an ordinary character 
rather than as a request for variable substitution. 


FEED [BACK] (6!/n|OFFJON} 


FLU(SH] {OFF ]ON} 


HEA[DING] {OFF |QN} 
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Displays the number of records returned by a 
query when a query selects at least n records. ON 
or OFF turns this display on or off. Turning 
feedback ON sets n to 1. Setting feedback to 0 is 
equivalent to turning it OFF. 


Controls when output is sent to the user’s display 
device. OFF allows the host operating system to 
buffer output. ON disables buffering. 


Use OFF only when you run a command file 
non-interactively (i.e., when you do not need to see 
output and/or prompts until the command file 
finishes running). The use of FLUSH OFF may 
improve performance by reducing the amount of 
program I/O. 

Controls printing of column headings in reports. 
ON prints column headings in reports; OFF 
suppresses column headings. 


HEADS [EP] {L|c}OFF|ON} 


LIN[ESIZE] {80|n)} 


LONG (80[n} 


MAXD [ATA] n 


NEWP [AGE] {11n} 


NULL text 


NUMF [ORMAT] format 


NUM[WIDTH] {1QIn} 


PAGES [IZE] {141n)} 


Defines the character you enter as the heading 
separator character. You can use the heading 
separator character in the COLUMN command 
and in the old forms of BTITLE and TTITLE to 
divide a column heading or title onto more than 
one line. ON or OFF turns heading separation on 
or off. When heading separation is OFF, SQL*Plus 
prints a heading separator character like any other 
character. 


Sets the total number of characters that SQL*Plus 
displays on a line before beginning a new line. It 
also controls the position of centered and 
right-aligned text in TTITLE and BTITLE. You can 
define LINESIZE as a value between 1 and 500. 


Sets maximum width for displaying and copying 
LONG values. Valid values are 1 to 32767, The 
value of LONG must be less than the value of 
MAXDATA. 


Sets the maximum total row width that SQL*Plus 
can process, The default and maximum values of n 
vary in different operating systems. See the Oracle 
installation and user’s manual(s) provided for your 
operating system or your DBA for details. 


Sets the number of blank lines to be printed 
between the beginning of each page and the top 
title. A value of 0 sends a formfeed between pages 
and clears the screen on most terminals. 


Sets the text that represents a null value in the 
result of a SQL SELECT command. NULL without 
text displays a blank (the default). Use the NULL 
clause of the COLUMN command to override the 
setting of the NULL variable for a given column. 


Sets the default format for displaying numbers. 
Enter a number format for format. For number 
format descriptions, see the FORMAT clause of the 
COLUMN command in this chapter. 


Sets the default width for displaying numbers. 
Sets the number of lines from the top title to the 
end of the page. For reports printed on paper 11 
inches long, a value of 54 (plus a NEWPAGE value 
of 6) leaves one-inch margins above and below the 
output. 
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You can set PAGESIZE to 0 to suppress all 
headings, page breaks, titles, the initial blank line, 
and other formatting information. 


PAU[SE] {OFF |ON| text} 


Allows you to control scrolling of your terminal 
when running reports. You must press [Return] or 
[Clear] after seeing each pause. ON causes 
SQL*Plus to pause at the beginning of each page of 
report output. The text you enter specifies the text 
to be displayed each time SQL*Plus pauses. If you 
enter multiple words, you must enclose text in 
single quotes. 


You can embed terminal-dependent escape 
sequences in the PAUSE command. These 
sequences allow you to create inverse video 
messages or other effects on terminals that support 
such characteristics. 


RECSEP (WRIAPPEDL{EA{CH)|OFF} and RECSEPCHAR { |c} 


SCAN {OFF |ON} 


Display or print record separators. A record 
separator consists of a single line of the 
RECSEPCHAR (record separating character) 
repeated LINESIZE times. 


RECSEPCHAR defines the record separating 
character. A blank space is the default for 
RECSEPCHAR. 


RECSEP tells SQL*Plus where to make the record 
separation. For example, if you set RECSEP to 
WRAPPED, SQL*Plus prints a record separator 
only after wrapped lines. If you set RECSEP to 
EACH, SQL*Plus prints a record separator 
following every row. If you set RECSEP to OFF, 
SQL*Plus does not print a record separator. 


Controls scanning for the presence of substitution 
variables and parameters. OFF suppresses 
processing of substitution variables and 
parameters; ON allows normal processing. 


SHOW[MODE] {OFF |ON} 


SPA(CE] {lin} 
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Controls whether SQL*Plus lists the old and new 
settings of a SQL*Plus system variable when you 
change the setting with SET. ON lists the settings; 
OFF suppresses the listing. BOTH functions in the 
same manner as ON. 


Sets the number of spaces between columns in 
output. The maximum value of n is 10. 


SQLC[ASE] {MIX [ED] |LO[WER] | UP [PER] } 
Converts the case of SQL commands and PL/SQL 
blocks just prior to execution. SQL*Plus converts 
all text within the command, including quoted 
literals and identifiers, as follows: 


* uppercase if SQLCASE equals UPPER 
> lowercase if SOLCASE equals LOWER 
* unchanged if SQLCASE equals MIXED 


SQLCASE does not change the SQL buffer itself. 


SQLCO[NTINUE] {> |text} 
Sets the character sequence SQL*Plus displays as a 
prompt after you continue a SQL*Plus command 
on an additional line using a hyphen (-). 


SOLN [UMBER] (OFF | ON} 
Sets the prompt for the second and subsequent 
lines of a SQL command or PL/SQL block. ON 
sets the prompt to be the line number. OFF sets 
the prompt to the value of SQLPROMPT. 


SQLPRE [FIX] {lc} Sets the SQL*Plus prefix character. While you are 
entering a SQL command or PL/SQL block, you 
can enter a SQL*Plus command on a separate line, 
prefixed by the SQL"Plus prefix character. 
SQL*Plus will execute the command immediately 
without affecting the SQL command or PL/SQL 
block that you are entering. The prefix character 
must be a non-alphanumeric character. 


SQLP(ROMPT] {SQL>| text} 
Sets the SQL*Plus command prompt. 


SQLT[BRMINATOR) (21 clOFF|ON} 
Sets the character used to end and execute SQL 
commands to c. OFF means that SQL*Plus 
recognizes no command terminator; you 
terminate a SQL command by entering an empty 
line. ON resets the terminator to the default 
semicolon (;). 


SUF [PIX] (SQL| text} 

Sets the default file suffix (extension) that 
SQL*Plus uses in commands that refer to 
command files. SUFFIX does not control 
extensions for output (spool) files. 

TAB (OFF|ON} Determines how SQL*Plus formats white space in 
output. OFF uses spaces to format white space in 
the output. ON uses the TAB character. The 
default value for TAB is system-dependent. Enter 
SHOW TAB to see the default value. 
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TERM[OUT] {OFF |ON} 


TI[ME] (QRE|ON)} 


TIMI[NG] {OFF |ON} 


TRIM[OUT] {OFF |QN} 


Controls the display of output generated by 
commands executed from a file. OFF suppresses 
the display so that you can spool output from a 
command file without seeing the output on the 
screen. ON displays the output. TERMOUT OFF 
does not affect output from commands you enter 
interactively. 


Controls the display of the current time. ON 
displays the current time before each command 
prompt. OFF suppresses the time display. 


Controls the display of timing statistics. ON 
displays timing statistics on each SQL command or 
PL/SQL block run. OFF suppresses timing of each 
command, For information about the data SET 
TIMING ON displays, see the Oracle installation 
and user's manuals) provided for your operating 
system. Refer to the TIMING command for 
information on timing multiple commands. 


Determines whether SQL*Plus allows trailing 
blanks at the end of each displayed line. ON 
removes blanks at the end of each line, improving 
performance especially when you access SQL*Plus 
from a slow communications device. OFF allows 
SQL*Plus to display trailing blanks. TRIMOUT 
ON does not affect spooled output; SQL*Plus 
ignores TRIMOUT ON unless you set TAB ON. 


UND ([ERLINE) {=| c|ON|OFF) 


VER[IFY] {OFF |ON} 


WRA(P] {OFF |QN} 
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Sets the character used to underline column 
headings in SQL*Plus reports to c. ON or OFF 
turns underlining on or off without affecting the 
value of c, 

Controls whether SQL*Plus lists the text of a 
command before and after SQL*Plus replaces 
substitution variables with values. ON lists the 
text; OFF suppresses the listing. 

Controls whether SQL*Plus truncates the display 
of a data item if it is too long for the current line 
width. OFF truncates the data item; ON allows the 
data item to wrap to the next line. 


Use the WRAPPED and TRUNCATED clauses of 
the COLUMN command to override the setting of 
WRAP for specific columns. 





Usage Notes 


Examples 


COMPATIBILITY 


ESCAPE 


HEADING 


SQL*Plus maintains system variables (also called SET command 
variables) to allow you to establish a particular environment for a 
SQL*Plus session. You can change these system variables with the SET 
command and list them with the SHOW command. 


Note: SET TRANSACTION READ ONLY is a SQL command; see the 
SQL Language Reference Manual for information. 


The following examples show sample uses of selected SET command 
variables. 


To run a command file, SALARY.SQL, created with Version 5 of 
ORACLE, enter: 


SQL> SET COMPATIBILITY V5 
SQL> START SALARY 


After running the file, reset compatibility to V6: 
SQL> SET COMPATIBILITY V6 


Alternatively, you can add the command SET COMPATIBILITY V5 to 
the beginning of the command file, and reset COMPATIBILITY to V6 at 
the end of the file. 


If you define the escape character as an exclamation point (!), then 
SQL> ACCEPT vl PROMPT ‘Enter !&1:° 

displays this prompt: 

Enter &1: 

To suppress the display of column headings in a report, enter: 
SQL> SET HEADING OFF 

If you then run a SQL SELECT command, 


SQL> SELECT ENAME, SAL FROM EMP 
2 WHERE JOB = ‘CLERK’; 


the following output results: 


ADAMS 1100 
JAMES 950 
MILLER 1300 
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LONG 


SQLCONTINUE 


SUFFIX 


To set the maximum width for displaying and copying LONG values 
to 500, enter: 


SQL> SET LONG 500 


The LONG data will wrap on your screen; SQL*Plus will not truncate 
until the 501st character. 


To set the SQL*Plus command continuation prompt to an exclamation 
point followed by a space, enter: 


SQL> SET SQLCONTINUE '! ' 


SQL*Plus will prompt for continuation as follows: 


SQL> TTITLE ‘YEARLY INCOME’ = 
! RIGHT SQL.PNO SKIP 2 - 

! CENTER ‘PC DIVISION’ 

SQL> 


To set the default command-file extension to UFI, enter: 
SQL> SET SUFFIX UFI 

If you then enter 

SQL> GET EXAMPLE 


SQL*Plus will look for a file named EXAMPLE with an extension of 
UFI instead of EXAMPLE with an extension of SOL. 
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Purpose 


Syntax 


Terms and Clauses 


Example 


SHO[W] option 


where option represents one of the following terms or clauses: 


system_variable 
ALL 
BTI[TLE] 
LNO 
PNO 
REL [EASE] 
SPOO[L] 
SQLCODE 
TTI(TLE) 
USER 





Refer to the following list for a description of each term or clause: 


system_variable 


ALL 
BII(TLE] 


LNO 


PNO 
REL [EASE] 


SPOO[L] 


SQLCODE 


TTI (TLE) 


USER 


| 
Lists the value of a SQL*Plus system variable. | 


Represents any system variable set by the SET 
command. 


Lists the settings of all SHOW options. 
Shows the current BTITLE definition. 
Shows the current line number (the position in the 


current page of the display and/or spooled 
output). 


Shows the current page number. 

Shows the release number of ORACLE RDBMS 
that SQL*Plus is accessing. 

Shows whether output is being spooled. 


Shows the value of SQL.LSQLCODE (for example, 
the SQL return code of the most recent operation). 
Shows the current TTITLE definition. 


Shows the username under which you are 
currently accessing SQL"Plus. 


To list the current LINESIZE, enter: 


SQL> SHOW LINESIZE 


If the current linesize equals 80 characters, SQL*Plus will give the 


following response: 


linesize 80 
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SPOOL 
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Purpose 


Syntax 


Terms and Clauses 


Usage Notes 


Examples 


Stores query results in an operating system file and, optionally, sends 
the file to a default printer. Also lists the current spooling status. 


SPO[OL] [file_name[.ext] |OFF|OUT] 


Refer to the following list for a description of each term or clause: 


file_name[.ext] Represents the name of the file to which you wish 
to spool. SPOOL followed by file_name begins 
spooling displayed output to the named file. If 
you do not specify an extension, SPOOL uses a 
default extension (LST or LIS on most systems). 


OFF Stops spooling. 


our Stops spooling and sends the file to your host 
computer’s standard (default) printer. 


Enter SPOOL with no clauses to list the current spooling status. 


To spool output generated by commands in a command file without 
displaying the output on the screen, use SET TERMOUT OFF. SET 
TERMOUT OFF does not affect output from commands run 
interactively. 


To record your displayed output in a file named DIARY using the 
default file extension, enter: 

SQL> SPOOL DIARY 

To stop spooling and print the file on your default printer, type: 
SQL> SPOOL OUT 
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SOLPLUS 


Purpose 


Syntax 


Terms and Clauses 


Starts SQL*Plus from the operating system prompt. 


SOQLPLUS [[-S{ILENT]] [logon] [start]] | 


=e 


where: 


logon 


start 


Requires the following syntax: 


username [/ password] [@database_ specification] | 
| 
/NOLOG 


Allows you to enter the name of a command file 
and arguments. SQL*Plus passes the arguments to 
the command file as though you executed the file 
using the SQL*Plus START command. The start 
clause requires the following syntax: 


@file_name[.ext) [argil arg2...] 


See the START command in this chapter for more 
information. 


You have the option of entering logon. If you do not specify logon, and 
do specify start, SQL*Plus assumes that the first line of the command 
file contains a valid logon. If neither start nor logon are specified, 
SQL*Plus prompts for logon information. 


Refer to the following list for a description of each term or clause: 


username [/password] 


Represent the username and password with which 
you wish to start SQL*Plus and connect to 
ORACLE, If you omit username and password, 
SQL*Plus prompts you for them. If you enter a 
slash (/) or simply enter [Return] to the prompt for 
username, SQL*Plus logs you on using a default 
logon (see "/" below). 


If you omit only password, SQL*Plus prompts you 
for password. When prompting, SQL*Plus does not 
display password on your terminal screen. 


Represents a default (ops$) logon. You cannot 
enter a database_specification if you use a default 
logon. Ina default logon SQL*Plus attempts to log 
you on using the username OPS$name, where name 
1s your operating system username. 
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Usage Notes 


/NOLOG Establishes no initial connection to ORACLE. 
Before issuing any SQL commands, you must issue 
a CONNECT command to establish a valid logon. 
Use /NOLOG when you want to have a SQL*Plus 
command file prompt the user for the name of a 
database. 

database_specification 
Consists of a SQL*Net connection string. The 
exact syntax depends upon the SQL*Net 
communications protocol your Oracle installation 
uses. For more information, refer to the SQL*Net 
manual appropriate for your protocol or contact 
your DBA. 

-S [ILENT] Suppresses all SQL*Plus information and prompt 
messages, including the command prompt and the 
banner normally displayed when you start 
SQL*Plus. Use SILENT to invoke SQL*Plus within 
another program so that the use of SQL*Plus is 
invisible to the user. 

-? Makes SQLPLUS display its current version and 
level number and then returns control to the 
operating system. Do not enter a space between 
the hyphen (-) and the question mark (?). 


SQL*Plus supports a Site Profile, a SQL*Plus command file created by 
the database administrator. SOL*Plus executes this command file 
whenever any user starts SQL*Plus and SQL*Plus establishes the 
ORACLE connection. The Site Profile allows the DBA to set up 
SQL*Plus environment defaults for all users at a particular site; users 
cannot directly access the Site Profile. The default name and location of 
the Site Profile depend on your system. Site Profiles are described in 
more detail in the Oracle installation and user’s manual(s) provided for 
your operating system. 


SQL*Plus also supports a User Profile, executed after the Site Profile. 
SQL*Plus searches for a file named LOGIN with the extension SQL in 
your current directory. If SQL*Plus does not find the file there, 
SQL*Plus will search a systern-dependent path to find the file. Some 
operating systems may not support this path-search. If SQL*Plus does 
not find the LOGIN file in the paths, SQL*Plus prints a warning 
message and continues the logon process. 
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Examples 


To start SQL*Plus with username SCOTT and password TIGER, enter: 
SQLPLUS SCOTT/TIGER 


To start SQL*Plus, as above, and to make POLICY the default database, 
enter: 

SQLPLUS SCOTT/TIGER@POLICY 

To start SOL*Plus and run a command file named STARTUP with the 
extension SQL, enter: 

SQLPLUS SCOTT/TIGER @STARTUP 


Note the space between TIGER and @STARTUP. 
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START 
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Purpose Executes the contents of the specified command file. 


Syntax STA[RT] file name[.ext] [argl arg2 ... ] 


Terms and Clauses Refer to the following list for a description of each term or clause: 


file_name[.ext] 


argl arg2... 
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Represents the command file you wish to execute. 
The file can contain any command that you can 
run interactively. 


If you do not specify an extension, SQL*Plus 
assumes the default command-file extension 
(normally SQL). For information on changing this 
default extension, see the SUFFIX variable of the 
SET command in this chapter. 


When you enter START file_name.ext, SQL*Plus 
searches for a file with the file name and extension 
you specify in the current default directory. If 
SQL*Plus does not find such a file, SQL"Plus will 
search a system-dependent path to find the file. 
Some operating systems may not support the 
path-search. Consult the Oracle installation and 
user’s manual(s) provided for your operating 
system for specific information related to your 
operating system environment. 


Represent data items you wish to pass to 
parameters in the command file. If you enter one 
or more arguments, SQL*Plus substitutes the 
values into the parameters (&1, &2, and so forth) 
in the command file. The first argument replaces 
each occurrence of &1, the second replaces each 
occurrence of &2, and so forth. 


The START command DEFINEs the parameters 
with the values of the arguments; if you START 
the command file again in this session, you can 
enter new arguments or omit the arguments to use 
the old values. 


For more information on using parameters, refer to 
the subsection "Passing Parameters through the 
START Command" under "Writing Interactive 
Commands" in Chapter 3. 


| 
| 
| 
| 
| 
| 
| 








Usage Notes 


Example 


The @ (“at" sign) command functions similarly to START, but does not 
allow the passing of values to parameters. 


A file named PROMOTE with the extension SQL, used to promote 
employees, might contain the following command: 


SELECT * FROM EMP 
WHERE MGR=&1 AND JOB='&2' AND SAL>&3; 


To run this command file, enter: 
SQL> START PROMOTE 7280 CLERK 950 


SQL*Plus then executes the following command: 


SELECT * FROM EMP 
WHERE MGR=7280 AND JOB='CLERK’ AND SAL>950; 
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Purpose 


Syntax 


Terms and Clauses 


Usage Notes 


Examples 


Oita 
Records timing data for an elapsed period of time, lists the current 
timing area’s title and timing data, or lists the number of active timing 
areas. 


TIMI(NG}] (START text |SHOW{STOP] 


Refer to the following list for a description of each term or clause: 


START text Sets up a timing area and makes text the title of the 
timing area. You can have more than one active 
timing area by STARTing additional areas before 
STOPping the first; SQL*Plus nests each new area 
within the preceding one. The area most recently 
STARTed becomes the current timing area. 


SHOW Lists the current timing area’s title and timing 
data. 
STOP Lists the current timing area’s title and timing 


data, and then deletes the timing area. If any other 
timing areas are active, the next most recently 
STARTed area becomes the current timing area. 
Use the TIMING clause of the CLEAR command to 
delete all timing areas. 


Enter TIMING with no clauses to list the number of active timing areas. 


You can use this data to do a performance analysis on any commands 
or blocks run during the period. 


For information about the data TIMING displays, see the Oracle 
installation and user’s manual(s) provided for your operating system. 
Refer to SET TIMING ON for information on automatically displaying 
timing data after each SQL command or PL/SQL block you run. 


To create a timing area named SQL_AREA, enter: 

SQL> TIMING START SQL_AREA 

To list the current timing area’s title and accumulated time, enter: 
SQL> TIMING SHOW 


To list the current timing area’s title and accumulated time and to 
remove the timing area, enter: 


SQL> TIMING STOP 
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TTITLE 


Purpose 


Syntax 


Terms and Clauses 


Places and formats a specified title at the top of each report page, or 
lists the current TTITLE definition. 


Note: Fora description of the old form of TTITLE, which is compatible 
with UFI (a predecessor of SQL*Plus), see TTITLE (old form) in 
Appendix F. 


TTI{TLE] [printspec [text|variable] ...] 
[OFF | QN] 


where printspec represents one or more of the following clauses used to 
place and format the fext: 


COL n 
S[KIP] [n} 
TAB n 

LE [FT] 

CE [NTER] 
R(IGHT] 
BOLD 
FORMAT char 


If you do not enter a printspec clause before the first occurrence of text, 
TTITLE left justifies the text. Enter TTITLE with no clauses to list the 
current TTITLE definition. 


Refer to the following list for a description of each term or clause. 
These terms and clauses also apply to the BTITLE command. 


text Represents the title text. Enter text in single quotes 
if you wish to place more than one word ona 
single line. 

variable Represents a user variable or any of the following 


system-maintained values: 


* SQL.LNO (current line number) 

* SQL.PNO (current page number) 

* SQL.RELEASE (current ORACLE release 
number) 

* SQLSQLCODE (current error code) 

e SQL.USER (current username) 


To print one of these values, reference the 
appropriate variable in the title. You can format 
variable with the FORMAT clause. 

OFF Turns the title off (suppresses its display) without 
affecting its definition. 
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COL n 


S[KIP]) fn] 


TAB n 


LE(FT), CE[NTER], 
and R[IGHT] 


BOLD 


FORMAT char 
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Turns the title on (restores its display). When you 
define a top title, SOL*Plus automatically sets 
TTITLE to ON. 


Indents to column of the current line (backward 
if column n has been passed). "Column" in this 
context means print position, not table column. 


Skips to the start of a new line n times; if you omit 
n, one time; if you enter zero for n, backward to the 
start of the current line. 


Skips forward n columns (backward if you enter a 
negative value for n). "Column" in this context 
means print position, not table column. 


Left-align, center, and right-align data on the 
current line respectively. SQL*Plus aligns 
following data items as a group, up to the end of 
the printspec or the next LEFT, CENTER, RIGHT, 
or COL command. CENTER and RIGHT use the 
SET LINESIZE value to calculate the position of 
the data item that follows. 


Prints data in bold print. SQL*Plus represents 
bold print on your terminal by repeating the data 
on three consecutive lines. 


Specifies a format model that determines the 
format of following data items, up to the next 
FORMAT clause or the end of the command. The 
format model must be a char constant such as A10 
or $999—not a variable. See COLUMN FORMAT 
for more information on formatting and valid 
format models. 


If the datatype of the format model does not match 
the datatype of a given data item, the FORMAT 
clause has no effect on that item. 


If no appropriate FORMAT model precedes a 
given data item, SQL*Plus prints NUMBER values 
according to the format specified by SET 
NUMEFORMAT or, if you have not used SET 
NUMEORMAT, the default format. SQL*Plus 
prints DATE values according to the default 
format. 


Refer to the FORMAT clause of the COLUMN 
command in this chapter for more information on 
default formats. 





Usage Notes 


Examples 


SQL*Plus interprets TTITLE in the new form if a valid printspec clause 
(LEFT, SKIP, COL, etc) immediately follows the command name. See 
COLUMN NEW_VALUE for information on printing column and 
DATE values in the top title. 


You can use any number of constants and variables in a printspec. 
SQL*Plus displays the constants and variables in the order you specify 
them, positioning and formatting each constant or variable as specified 
by the printspec clauses that precede it. 


To define "Monthly Analysis" as the top title and to left-align it, to 
center the date, to right-align the page number with a three-digit 
format, and to display “Date in Thousands" in bold in the center of the 
next line, enter: 


SQL> TTITLE LEFT ‘Monthly Analysis’ CENTER ‘11 Mar 88/ - 
> RIGHT ‘Page:’ FORMAT 999 SQL.PNO SKIP CENTER BOLD - 
> ‘Data in Thousands’ 


The following title results: 


Monthly Analysis 11 Mar 88 Page: 1 
Data in Thousands 


To suppress the top title display without changing its definition, enter: 


SQL> TTITLE OFF 
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UNDEFINE 


Purpose 


Syntax 


Terms and Clauses 


Example 


Deletes a given user variable that you defined either explicitly (with the 
DEFINE command) or implicitly (with an argument to the START 
command). 


UNDEF {INE] variable 


Refer to the following list for a description of each term or clause: 

variable Represents the name of the user variable you wish 
to delete. 

To undefine a user variable named POS, enter: 


SQL> UNDEFINE POS 
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WHENEVER SQLERROR 


Purpose 


Syntax 


Terms and Clauses 


Examples 


Exits SQL*Plus if a SQL command or PL/SQL block generates an error. 


WHENEVER SQLERROR {EXIT [SUCCESS |FAILURE|WARNING|n| variable) | 


Refer to the following list for a description of each term or clause: 


CONTINUE} 


EXIT (SUCCESS |FATLURE |WARNING|n|variable] 
Directs SQL*Plus to commit pending changes to 
the database and exit as soon as SOL*Plus detects 
any SQL error (but after printing the SQL error 


message). The EXIT clause of WHENEVER 


SQLERROR follows the same syntax as the EXIT 


command, See EXIT in this chapter for details. 


The EXIT clause will not exit if a SQL*Plus 
command generates an error. 


CONTINUE Turns off the EXIT option. 


The commands in the following command file cause SQL*Plus to exit 
and display the SQL error code if a SQL UPDATE command fails and 
skips the COPY command: 


SQL> GET RAISE 


K 


ama wN 


WHENEVER SQLERROR EXIT SQL.SQLCODE 
UPDATE EMP SET SAL = SAL*1,1 

COPY TO SCOTT/TIGER@D:BETHESDA - 
REPLACE EMP ~ 

USING SELECT * FROM EMP 

WHENEVER SQLERROR CONTINUE 
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APPENDIX 


CPY0002: 


Cause: 


Action: 
CPY0003: 


Cause: 


Action: 


COPY COMMAND 
ERROR MESSAGES 


ppendix A lists error messages generated by the COPY command. 
For error messages generated by the ORACLE RDBMS, refer to 
the ORACLE Error Messages and Codes manual. 
Illegal or missing APPEND, CREATE, INSERT, or REPLACE option 


An internal COPY function has invoked COPY with a create option 
(flag) value that is out of range. 


Please contact your Oracle Customer Support representative. 
Internal Error: logical host number out of range 


An internal COPY function has been invoked with a logical host 
number value that is out of range. 


Please contact your Oracle Customer Support representative. 
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CPY0004: 


Cause: 


Action: 


CPY0005: 


Cause: 


Action: 


CPY0006: 


Cause: 


Action: 


CP Y0007: 


Cause: 


Action: 


Source and destination table and column names don’t match 


On an APPEND operation or an INSERT (when the table exists), at least 
one column name in the destination table does not match the 
corresponding column name in the optional column name list or in the 
SELECT command. 


Re-specify the COPY command, making sure that the column names 
and their respective order in the destination table match the column 
names and column order in the optional column list or in the SELECT 
command. 


Source and destination column attributes don’t match 


Onan APPEND operation or an INSERT (when the table exists), at least 
one column in the destination table does not have the same datatype as 
the corresponding column in the SELECT command. 


Re-specify the COPY command, making sure that the datatypes for 
items being selected agree with the destination. You can use 
TO_DATE, TO_CHAR, and TO_NUMBER to make conversions. 


Select list has more columns than destination table 


On an APPEND operation or an INSERT (when the table exists), the 
number of columns in the SELECT command is greater than the 
number of columns in the destination table. 


Re-specify the COPY command, making sure that the number of 
columns being selected agrees with the number in the destination table. 


Select list has fewer columns than destination table 


On an APPEND operation or INSERT (when the table exists), the 
number of columns in the SELECT command is less than the number of 
columns in the destination table. 


Re-specify the COPY command, making sure that the number of 
columns being selected agrees with the number in the destination table. 
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CPY0008: 


Cause: 


Action: 


CPY0009: 


Cause: 


Action: 


More column list names than columns in the destination table 


Onan APPEND operation or an INSERT (when the table exists), the 
number of columns in the column name list is greater than the number 
of columns in the destination table. 


Re-specify the COPY command, making sure that the number of 
columns in the column list agrees with the number in the destination 
table. 


Fewer column list names than columns in the destination table 


On an APPEND operation or an INSERT (when the table exists), the 
number of columns in the column name list is less than the number of 
columns in the destination table. 


Re-specify the COPY command, making sure that the number of 


columns in the column list agrees with the number in the destination 
table. 
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APPENDIX 


VERSION 3.0 
ENHANCEMENTS 


S QL*Plus Version 3.0 gives you the following capabilities: 


You can choose whether SQL*Plus stores the ORACLE 
Version 6 commands COMMIT and ROLLBACK in the SQL 
buffer. A new SET variable, COMPATIBILITY, allows you to 
maintain compatibility with command files written with 
ORACLE Version 5. See the COMPATIBILITY variable of the 
SET command in Chapter 6 for more information. 


You can enter, edit, store, and execute PL/SQL blocks through 
SQL*Plus. Refer to the subsection “Running PL/SQL Blocks" 
under “Entering and Executing Commands" in Chapter 2 for 
details. 

* You will automatically see improved efficiency in a network 
environment. SQL*Plus now defines multiple columns in a 
SELECT command with a single network message. 

» You can restrict users’ access to given SQL and SQL*Plus 
commands through a table, PRODUCT_USER_PROFILE, 
located in the SYSTEM account. See Appendix E for a full 
explanation. 

* You can omit the password from the FROM and TO clauses of 

the COPY command; SQL*Plus prompts you for each 

password and suppresses the display of your response. Refer 
to the COPY command in Chapter 6 for details. 
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APPENDIX 


SOL*PLUS LIMITS 


: I ‘able C-1, on the following page, lists the limit, or maximum value, 
of each of the SQL*Plus elements shown. The limits shown are 
valid for most operating systems (all except PDP11 and mc68000). 


SQL*Plus Limits C-1 





TABLE C-1 
SQL*Plus Limits 





Item Limit 

file name length system-dependent 
username length 30 characters 

user variable name length 30 characters 

user variable value length 240 characters 
number of user variables 1,024 

number of variables in a SQL 50 

INSERT command INTO list 

number of variables per SQL 100 

command 

command line length 500 characters 
length of a LONG value 250 characters 
entered through SQL*Plus 

output line size 500 characters (minimum line size 


line size after variable 
substitution 


number of lines per SQL 
command 


number of lines per page 


total row width 


number of rows in an array fetch 


number of nested command files 


page number 
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is 5 characters) 
1,000 characters (internal only) 


500 (assuming 80 characters per 
line) 


50,000 


60,000 characters for VMS, 
otherwise 32,767 characters 


5000 


20 for VMS, CMS, Unix; 
otherwise, 5 


99,999 





APPENDIX 


SOL COMMAND LIST 


Te D-1, on the following page, lists major SQL commands and 
clauses. SQL commands were formerly documented in this 
manual. You can now refer to the SQL Language User's Guide and the 
SQL Language Reference Manual for full documentation of these 
commands and clauses. 
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TABLE D-1 Major SQL Commands and Clauses 





SQL Command List 
ALTER 
AUDIT 
CLOSE Cursor 
COMMENT 
COMMIT 
CONNECT 
CONNECT BY 
CREATE 
DECLARE 
DELETE 
DESCRIBE 
DROP 
EXECUTE 
EXPLAIN 
FETCH 
FOR 
FROM 
GRANT 
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GROUP BY 
HAVING 

INSERT 

LOCK TABLE 
NOAUDIT 

OPEN Cursor 
ORDER BY 
PREPARE 
RENAME 
REVOKE 
ROLLBACK 
SAVEPOINT 
SELECT 

SET TRANSACTION 
UPDATE 
VALIDATE INDEX 
WHENEVER 
WHERE 





APPENDIX 


RESTRICTING USERS’ 
PRIVILEGES IN 
SQL*PLUS 


ppendix C describes the use of the PRODUCT_USER_ PROFILE 

table by SQL*Plus. Various ORACLE products use 
PRODUCT_USER_PROFILE, a table in the SYSTEM account, to 
provide product-level security that supplements the user-level security 
provided by the SQL GRANT and REVOKE commands. DBAs can use 
PRODUCT_USER_PROFILE to disable certain SQL and SQL*Plus 
commands in the SQL*Plus environment, on a per-user basis. Note 
that SQL*Plus—not the ORACLE RDBMS—enforces this security. 


You can use PRODUCT_USER_PROFILE with your own applications 
as well as with other ORACLE products. This appendix discusses the 
specific use of PRODUCT_USER_PROFILE by SQL*Plus and also 
provides a guideline for other uses of the table. See your DBA for more 
information on accessing PRODUCT_USER_PROFILE. 


If you restrict a user's privileges through ORACLE’s GRANT and 
REVOKE commands, but do not restrict those privileges in 
PRODUCT_USER_PROFILE, the restrictions still apply. If you deny a 
user access to given commands through PRODUCT_USER_PROFILE, 
but do not place any restrictions with GRANT or REVOKE, access is 
still denied. 
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You can create PRODUCT_USER_PROFILE by running the command 
file named PUPBLD with the extension SQL. The exact format of the 
file extension and the location of the file are system-dependent. See the 
Oracle installation and user’s manual(s) provided for your operating 
system or your DBA for more information. 


SQL*Plus reads restrictions from PRODUCT_USER_PROFILE when a 
user logs on to SQL*Plus and maintains those restrictions for the 
duration of the session. Changes to PRODUCT_USER_PROFILE will 
only take effect the next time the affected user(s) log on to SQL*Plus. 


Table Structure 
The table consists of the following columns: 
Name Null? Type 
PRODUCT NOT NULL CHAR (30) 
USERID CHAR (30) 
ATTRIBUTE CHAR (240) 
SCOPE CHAR (240) 
NUMERIC_VALUE NUMBER (15, 2) 
CHAR_VALUE CHAR (240) 
DATE_VALUE DATE 


eeann ei i ein aa inova i 
Description and Use of Columns 


Refer to the following list for the descriptions and use of each column 
in the PRODUCT_USER_PROFILE table: 


Product Must contain the product name (in this case 
"SQL*Plus"). You cannot enter wildcards in this 
column. You also cannot enter NULL. 


Userid Must contain the username (in upper case) of the 
user for whom you wish to disable the command. 
To disable the command for more than one user, 
use SQL wild cards (%) or make multiple entries. 
Thus, all of the following entries are valid: 


* SCOTT 

* CLASSI 

e CLASS% (all users whose names start 
with CLASS) 

e % (all users) 
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Attribute Must contain the name (in upper case) of the SQL 
or SQL*Plus command you wish to disable (e.g., 
GET). You cannot enter a wildcard. See 
"Administration," below, for a list of SQL and 
SQL*Plus commands you can disable. 


Scope SQL*Plus ignores this column. It is recommended 
that you enter NULL in this column. Other 
products may store specific file restrictions or other 
data in this column. 


Numeric_Value SQL*Plus ignores this column. It is recommended 
that you enter NULL in this column. Other 
products may store numeric values in this column. 


Char_Value Must contain the character string "DISABLED". 
You cannot use a wildcard. 


Date_Value SQL*Plus ignores this column. It is recommended 
that you enter NULL in this column. Other 
products may store DATE values in this column. 


Administration 


The DBA username SYSTEM owns and has all privileges on 
PRODUCT_USER_PROFILE. (When SYSTEM logs on, SQL*Plus does 
not read PRODUCT_USER_PROFILE. Therefore, no restrictions apply 
to user SYSTEM.) Other ORACLE usernames should have only 
SELECT access to this table. The command file PUPBLD, when run, 
grants SELECT access on PRODUCT_USER_PROFILE to PUBLIC. 


To disable a SQL or SQL*Plus command for a given user, insert a row 
containing the user’s username in the Userid column, the command 
name in the Attribute column, and DISABLED in the Char_Value 
column. The Scope, Numeric_Value, and Date_Value columns should 
contain NULL. For example: 


NUMERIC CHAR DATE 
PRODUCT USERID ATTRIBUTE SCOPE VALUE VALUE VALUE 
SQL*Plus SCOTT HOST DISABLED 
SQL*Plus $% INSERT DISABLED 
SQL*Plus % UPDATE DISABLED 
SQL*Plus $% DELETE DISABLED 


To re-enable commands, delete the row containing the restriction. 
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You can disable the following SQL*Plus commands: 


+ CONNECT 

+ EDIT 

« EXIT 

+ GET 

+ HOST (or your operating system’s alias for HOST, such as $) 

+ QUIT 

* RUN 

+ SAVE 

+ SPOOL 

+ START 
You can also disable the following SQL commands: 

+ ALTER 

* AUDIT 

+ CONNECT 

» CREATE 

+ DELETE 

« DROP 

+ GRANT 

+ INSERT 

+ LOCK 

+ NOAUDIT 

+ RENAME 

+ REVOKE 

+ SELECT 

+ UPDATE 

+ VALIDATE 
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APPENDIX 


SOL*PLUS 
COMMANDS FROM 
EARLIER VERSIONS 


ppendix F covers earlier versions of some SQL*Plus commands. 
These older commands still function within SQL*Plus, but 
SQL*Plus provides newer commands that have improved functionality. 
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BTITLE (old form) 


Purpose Displays a title at the bottom of each report page. 


Syntax BTI[TLE] text 


Usage Notes The old form of BTITLE offers formatting features more limited than 
those of the new form, but provides compatibility with UFI (a 
predecessor of SQL*Plus). The old form defines the bottom title as an 
empty line followed by a line with centered text. Refer to TTITLE (old 
form) in this appendix for more details. 


COLUMN DEFAULT 


Purpose Resets the display attributes for a given column to default values. 
Syntax COL{UMN] {column|expr) DEF [AULT] 


Usage Notes Has the same effect as COLUMN CLEAR. 


DOCUMENT 


Purpose Begins a block of documentation in a command file. 
Syntax DOC [UMENT] 


Usage Notes For information on the current method of inserting comments ina 
command file, refer to the subsection "Placing Comments in Command 
Files" under "Saving Commands for Later Use" in Chapter 3 and to 
REMARK in Chapter 6. 


After you type DOCUMENT and enter [Return], SQL*Plus displays the 
prompt DOC> in place of SQL> until you end the documentation. The 
"pound" character (#) ona line by itself ends the documentation. 


If you have set DOCUMENT to OFF, SQL*Plus ignores the 
DOCUMENT command and interprets subsequent lines of 
documentation as commands. (See SET DOCUMENT later in this 
appendix.) 
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NEWPAGE 
Purpose Advances spooled output n lines beyond the beginning of the next 
page. 


Syntax NEWPAGE [Lin] 


Usage Notes Refer to the NEWPAGE variable of the SET command in Chapter 6 for 
information on the current method for advancing spooled output. 


Ft 
SET BUFFER 


Purpose Makes the specified buffer the current buffer. 
Syntax SET BUF(FER) {buffer|SOL) 


Usage Notes _ Initially, the SQL buffer is the current buffer. SQL*Plus does not 
require the use of multiple buffers; the SQL buffer alone should meet 
your needs. 


If the buffer name you enter does not already exist, SET BUFFER 


defines (creates and names) the buffer. SQL*Plus deletes the buffer and 
its contents when you exit SQL*Plus. 


Running a query automatically makes the SQL buffer the current 
buffer. To copy text from one buffer to another, use the GET and SAVE 
commands. To clear text from the current buffer, use CLEAR BUFFER. 
To clear text from the SQL buffer while using a different buffer, use 
CLEAR SQL. 


TSO 
SET DOCUMENT 


Purpose Enables or disables the DOCUMENT command. 
Syntax SET DOC[UMENT] {OFF |ON) 


Usage Notes SET DOCUMENT ON enables the DOCUMENT command. SET 
DOCUMENT OFF disables it. If you disable DOCUMENT, SQL*Plus 
interprets any lines following a DOCUMENT command as commands. 


See DOCUMENT in this appendix for information on the DOCUMENT 
command. 
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SET TRUNCATE 


Purpose 


Syntax 


Usage Notes 


Controls whether SQL*Plus truncates or wraps a data item that is too 
long for the current line width. 


SET TRU{NCATE] {OFE|ON} 
ON functions in the same manner as SET WRAP OFF, and vice versa. 


You may prefer to use WRAP because the SHOW command recognizes 
WRAP and does not recognize TRUNCATE. 


TTITLE (old form) 
Purpose 
Syntax 
Usage Notes 
F-4 


Displays a title at the top of each report page. 
TTI[TLE] text 


The old form of TTITLE offers formatting features more limited than 
those of the new form, but provides compatibility with UFI (a 
predecessor of SQL*Plus). The old form defines the top title as a line 
with the date left-aligned and the page number right-aligned, followed 
by a line with centered text and then a blank line. 


The text you enter defines the title TITLE will display. 


SQL*Plus centers text based on the size of a line as determined by SET 
LINESIZE. A separator character (1) begins a new line; two line 
separator characters in a row (| |) insert a blank line. You can change 
the line separator character with SET HEADSEP. 


You can control the formatting of page numbers in the old forms of 
TITLE and BTITLE by defining a variable named "_page". The default 
value of _page is the formatting string, "page &P4". To alter the format, 
you can DEFINE _page with a new formatting string as follows: 


SQL> SBT ESCAPE / 
SQL> DEFINE _page = ‘Page /&P2' 
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Example 


This formatting string will print the word "page" with an initial capital 
letter and format the page number to a width of 2. You can substitute 
any text for "page" and any number for the width. You must set escape 
so that SQL*Plus does not interpret the ampersand (&) as a substitution 
variable. See the ESCAPE variable of the SET command in Chapter 6 
for more information on setting the escape character. 


SQL*Plus interprets TTITLE in the old form if a valid new-form clause 
does not immediately follow the command name. 


To use the old form of TTITLE to set a top title with a left-aligned date 
and right-aligned page number on one line followed by SALES 
DEPARTMENT on the next line and PERSONNEL REPORT on a third 
line, enter: 


SQL> TTITLE ‘SALES DEPARTMENT {PERSONNEL REPORT’ 
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GLOSSARY 


A 


argument A data item following the 
command-file name in a START command. 
The argument supplies a value for a parameter 
in the command file. 


ASCII A convention for using digital data to 
represent printable characters. ASCII is an 
acronym for American Standard Code for 
Information Interchange. 


autocommit A feature unique to SQL*Plus 
that enables SOL*Plus to au tomatically commit 
changes to the database after every successful 
execution of a SQL command or PL/SQL 
block. Setting the AUTOCOMMIT variable of 
the SET command to ON enables this feature. 


B 


block InPL/SQL,a group of SQL and 
PL/SQL commands related to one another 
through procedural logic. 


break An event, such asa change in the 
value of an expression, that occurs while 
SQL*Plus processes a query or report. You can 
direct SQL*Plus to perform some action, such 
as printing totals, whenever a break occurs. 


break column A column ina report that 
causes a break when its value changes. 


break hierarchy The order in which 
SQL*Plus checks for the occurrence of events 
and triggers the corresponding breaks. 


buffer An area where SQL*Plus saves your 
most recently entered SQL command or 
PL/SQL block. The SQL buffer is the default 
buffer. You can edit or execute commands 
from multiple buffers; however, SQL*Plus 
does not require the use of multiple buffers. 


Cc 


CHAR datatype One of the standard 
ORACLE datatypes. A CHAR column can 
contain any printable characters, such as A, 3, 
&, or a blank, and can have any length from 
zero characters up to the maximum width for a 
column, which you can define as any value 
from 1 to 255 characters. 


column (1) The fields representing one kind 
of data in a table; for example, the fields 
representing salary in the sample table EMP. 
(2) The fields representing one kind of data in 
the output of a query. See also row. 
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command An instruction to SQL*Plus. 
ACCEPT, CLEAR, and COPY are examples of 
commands in SQL*Plus. 


command file A file containing one or more 
commands. You can execute the command file 
with the START or @ command. 


command prompt The text, by default 
SQL>, with which SOL*Plus requests your 
next command. 


commit To make changes to data (inserts, 
updates, deletes) permanent. Before changes 
are stored, both the old and new data exist so 
that changes can be stored or the data can be 
restored to its prior state. When a user enters 
the SQL command COMMIT, all changes in 
that transaction are made permanent. 


connect To identify yourself to ORACLE by 
entering your username and password in 
order to gain access to the database. In 
SQL*Plus, the CONNECT command allows 
you to log off ORACLE and then log back on 
with a specified username. 


currentline The line in the buffer that 
SQL*Plus editing commands will affect at any 
given time. 


D 


database A disk storage area where 
ORACLE stores tables, views, and other data; 
also, the set of objects stored in that area. 


Database Administrator (DBA) A person 
responsible for the operation and maintenance 
of the ORACLE RDBMS. The DBA is an 
ORACLE user authorized to grant and revoke 
other users’ access to the system, modify 
ORACLE options that affect all users, and 
perform other administrative functions. There 
may be more than one DBA per site. 
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database link An object stored in the local 
database that identifies a remote database, a 
communication path to the remote database, 
and optionally, a username and password for 
it. Once defined, a database link can be used 
to perform queries on tables in the remote 
database. Also called DBlink. In SQL*Plus, 
you can reference a database link in a 
DESCRIBE or COPY command. 


database specification An alphanumeric 
code that identifies an ORACLE database, 
used to specify the database in SQL*Net 
operations and to define a database link. In 
SQL*Plus, you can reference a database 
specification in a COPY, CONNECT, or 
SQLPLUS command. 


datatype Any one of the forms of data that 

ORACLE can store and manipulate. The SQL 
language recognizes the following datatypes: 
CHAR, DATE, NUMBER, LONG, RAW, and 

LONG RAW. 


DATE datatype One of the standard 
ORACLE datatypes. A DATE column can 
contain a date and time from January 1, 4712 
BC to December 31, 4712 AD. Standard date 
format is 01-JAN-88 (DD-MM-YY). 


DBA See Database Administrator. 


DCLcommands A category of SQL 
commands that control access to the data and 
to the database. DCL stands for data control 
language. 


DDLcommands A category of SQL 
commands that define or delete database 
objects such as tables or views. DDL stands 
for data definition language. 


default A clause or option value that 
SQL*Plus uses if you do not specify an 
alternative. 


default database See local database. 


DML commands A category of SQL 
commands that query and update the actual 
data. DML stands for data manipulation 


language. 
E 


error message A message from a computer 
program (e.g., SQL*Plus) informing you of a 
potential problem preventing program or 
command execution. 


F 


file A collection of data treated as a unit, 
such as a list, document, index, note, set of 
procedures, etc.—the basic unit of information 
maintained by an operating system. Generally 
used to refer to data stored on magnetic tapes 
or disks. 


format model A clause element that controls 
the appearance of a value in a report column. 
You specify predefined format models in the 
COLUMN, TTITLE, and BTITLE commands’ 
FORMAT clauses. You can also use format 
models for DATE columns in SQL date 
conversion functions, such as TO_DATE. 


formfeed A control character that, when 
executed, causes the printer to skip to the top 
of a new sheet of paper (top of form). When 
SQL*Plus displays a formfeed on most 
terminals, the formfeed clears the screen. 


H 


heading Text that appears above a report 
column to name the column. 


hostcomputer The computer from which 
you run SQL*Plus. 


Julian date An algorithm for expressing 
dates in integer form, using the JDATE 
function and date formatting. Julian dates 
allow additional arithmetic functions to be 
performed on dates. 


L 


local database The database that SQL*Plus 
connects to when you start SQL*Plus, 
ordinarily a database on your host computer. 
Also called a default database. See also remote 
database, 


LONG datatype One of the standard 
ORACLE datatypes. A LONG column can 
contain any printable characters such as A, 3, 
&, or a blank, and can have any length from 0 
to 65,535 characters. 


N 


network Two or more computers linked 
together through hardware and software to 
allow the sharing of peripherals. 


null A value that means, "a value is not 
applicable" or "the value is unknown." Nulls 
are not equal to any specific value, even to 
each other. Comparisons with nulls are 
always false. 


NUMBER datatype One of the standard 
ORACLE datatypes. A NUMBER column can 
contain a number, with or without a decimal 
point and a sign, and can have from 1 to 105 
decimal digits (only 40 digits are significant). 


o 


operating system The system software that 
manages the computer's resources, performing 
basic tasks such as allocating memory and 
allowing computer components to 
communicate. 
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ORACLERDBMS The relational database 
management system (RDBMS) sold by Oracle 
Corporation. Oracle Corporation sells 
SQL*Plus as an optional product for use with 
the ORACLE RDBMS. 


P 


page A screen of displayed data or a sheet of 
printed data in a report. 


parameter A substitution variable consisting 
of an ampersand followed by a numeral (&1, 
&2, etc.). You use parameters in a command 
file and pass values into them through the 
arguments of the START command. 


password A secondary identification word 
associated with a username. A user logging on 
to the system must supply the correct 
password before the system will permit access. 
This security measure helps to prevent 
unauthorized people from working with files. 


PL/SQL A procedural language extension of 
SQL that provides programming constructs 
like blocks, conditionals, and procedures. 


prompt A message froma computer 
program that instructs you to enter data or 
take some other action. 


Q 


query A frequently used type of SQL 
command, used to retrieve information from 
tables or views. Queries typically begin with 
the SQL reserved word SELECT. 


query results The data retrieved by a query. 
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R 


RAW datatype One of the standard 
ORACLE datatypes. A RAW column can 
contain data in any form, including binary. 


RDBMS See relational database management 
system. 


record A row in a database. 


relational database management system 

A computer program for general-purpose data 
storage and retrieval, also called the RDBMS. 
Data is stored in tables consisting of one or 
more units of information (rows), each 
containing the same set of data items 
(columns). ORACLE is a relational database 
management system. 


remote computer A term used to refer to any 
computer in a network other than one’s own 
host computer. 


remote database A database other than your 
default database, which may reside ona 
remote computer; in particular, one that you 
reference in the CONNECT, COPY, and 
SQLPLUS commands. 


reserved word One of a number of words 
that have special meaning to the ORACLE 
RDBMS; you cannot use a reserved word as 
the name of a database object. Examples are 
TABLE, NUMBER, DATE, SELECT. 


roll back To discard pending changes made 
to the data in the current transaction using the 
SQL ROLLBACK command. You can roll back 
a portion of a transaction by identifying a 
savepoint. 





row (1) One set of fields in a table; for 
example, the fields representing one employee 
in the sample table EMP. (2) One set of fields 
in the output of a query. 


S 


session The events that happen between the 
time you connect to SQL*Plus and the time 
you disconnect. 


SET command variable See system variable. 


spooling Theactof writing displayed 
output to a disk storage area. The SPOOL 
command controls spooling. 


SQL Structured Query Language, the ANSI, 
industry-standard language used to 
manipulate information in a relational 
database. SQL is the language used in 
ORACLE and IBM DB2 relational database 
management systems. SQL is pronounced 
sequel. See also DCL commands, DDL 
commands, and DML commands. 


SQL buffer The default buffer containing 
your most recently entered SQL command or 
PL/SQL block. 


SQL*Forms A non-procedural tool for 
creating, maintaining, and running 
forms-based, interactive applications using an 
ORACLE database. 


SQL*Net An Oracle network product that 
works with the ORACLE RDBMS and enables 
two or more computers that ran ORACLE to 
exchange database data through a network. 


SQL*Plus A software product that allows 
users to interactively use SQL commands or 
PL/SQL blocks and that produces formatted 
reports and supports written-command 
procedures to access data in an ORACLE 
database. 


substitution variable A variable name or 
numeral preceded by one or two ampersands 
(&). You use a substitution variable in a 
command file to represent a value that you 
will provide when you run the command file. 


subtotal The total of values ina NUMBER 
column, taken over a group of rows that have 
the same value in a break field. 


summary line A line in a report containing 
totals, averages, maximums, or other 
computed values. You create summary lines 
through the BREAK and COMPUTE 
commands. 


syntax A set of rules that determines how to 
construct a valid command in a computer 
language, such as SQL. 


system editor A program on the host 
computer used to edit text in host operating 
system files. 


system variable A variable predefined and 
set to a default value by ORACLE or SQL*Plus 
to indicate status or environment. You can list 
the values of and set many system variables 
with the SHOW and SET commands, 
respectively. An example is LINESIZE, which 
determines the number of characters that 
SQL*Plus displays on a line before beginning a 
new line. 
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T 


table The basic unit of storage in a relational 
database management system. A table 
consists of one of more rows and one or more 
columns. 


texteditor A program run under your host 
computer’s operating system that you use to 
create and edit host system files and SQL*Plus 
command files containing SQL commands, 
SQL*Plus commands, and/or PL /SQL blocks. 


timing area An internal storage area created 
by the TIMING command. 


title A line that appears at the top or bottom 
of each report page. You establish and format 
titles through the TTITLE and BTITLE 
commands. 


transaction The SQL commands that occur 
between one CONNECT, COMMIT, or 
ROLLBACK (without mentioning a savepoint) 
and another. Note that a COMMIT can occur 
explicitly with the use of the SQL COMMIT 
command, or implicitly through commands 
such as the SQL*Plus EXIT command or SQL 
DDL commands. 


truncate An operation where one or more 
characters are discarded from the end of a 
value. 


U 


username (1) The name a user enters to log on 
to the host system. (2) The name by which a 
user is known to the ORACLE database and to 
other users, as in the prefix to a table name (for 
example SCOTT, in the table SCOTT.EMP). 
Every username is associated with a private 
password, and both must be entered in the 


data dictionary in order to connect to ORACLE. 
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user variable A variable defined and set by 
you explicitly with the DEFINE command or 
implicitly with an argument to the START 
command. 


v 


variable A named object that holds a single 
value. SOL*Plus uses substitution, system, 
and user variables. 


Ww 


wrapping The process of moving some 
words or letters of a heading or data item to a 
new line when the heading or data does not fit 
on one line. 


Index 


Special Characters 


. (period) 
See Period (.) 
; (semicolon) 
See Semicolon (;) 
@ (“at" sign) 
in CONNECT command 5-3, 6-29 
in COPY command 5-4, 6-31 
in SQLPLUS command 3-12, 5-3, 6-65 
@ ("at" sign) command 3-12, 6-5 
command file 3-12, 6-5 
similar to START 3-12, 6-5, 6-69 
$, number format 4-4, 6-20 
& (ampersand) 
See Substitution variables 
* (asterisk), in LIST command 3-2, 6-45 
-- (comment delimiter) 3-10 
-? clause 6-66 
-SILENT clause 6-66 
/ (slash) command 2-8, 6-6 
entered at buffer line-number prompt 2-7, 6-6 
entered at command prompt 2-8, 6-6 
executing current PL/SQL block 2-8 
executing current SQL command 2-8 
similar to RUN 2-8, 6-6, 6-50 
/ (slash), default logon 6-65 
/*..*/ (comment delimiters) 3-10 
/NOLOG option 6-66 
0, number format 4-4, 6-20 
9, number format 4-4, 6-20 
_EDITOR, in EDIT command 3-6, 6-39 


A 


ACCEPT command 3-24, 6-7 
and DEFINE command. 6-34 
CHAR clause 6-7 
customizing prompts for value 3-25 
HIDE clause 6-7 
NOPROMPT clause 6-7 
NUMBER clause 3-26 
PROMPT clause 3-24, 6-7 
Access, denying and granting E-1 
ALIAS clause 6-18 
ALL clause 6-63 
ALTER command 
disabling E-4 
See also your Oracle SQL language 
documentation 
Ampersands (&) 
in parameters 3-22, 6-68 
See also Substitution variables 
APPEND clause 
in COPY command 5-6, 6-32 
in SAVE command 3-14, 6-52 
APPEND command_ 3-2, 3-5, 6-8 
Arguments, in START command 3-22, 6-68 
ARRAYSIZE variable 6-54 
relationship to COPY command 5-7, 6-32 
AUDIT command 
disabling E-4 
See also your Oracle SQL language 
documentation 
AUTOCOMMIT variable 2-11, 6-54 
AVG function 4-13, 6-25 
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B 


B, number format 6-20 
[Backspace] key 2-2 
Batch mode 3-14, 6-40 
BEGIN command 2-8 
See also your PL/SQL User's Guide and Reference 
Blank line 
in PL/SQL blocks 2-8 
in SQL commands 2-8 
Block, PL/SQL 
saving current 3-7, 6-52 
Blocks, PL/SQL 1-2 
continuing 2-8 
editing in buffer 3-2 
editing with host system editor 3-6, 6-39 
entering and executing 2-8 
listing current in buffer 3-3 
setting character used to end 6-54 
stored in SQL buffer 2-8 
storing in command files 3-7 
timing statistics 6-60 
BLOCKTERMINATOR variable 6-54 
BOLD clause 6-72 
Break columns 4-9, 6-9 
inserting space when value changes 4-10 
specifying multiple 4-11 
suppressing duplicate values in 4-10 
BREAK command 4-9, 6-9 
and SQL ORDER BY clause 4-9 to 4-11, 6-10 
displaying column values in titles 4-23 
DUPLICATES clause 6-12 
inserting space after every row 4-11 
inserting space when break column changes 
4-10 
listing current break definition 4-12, 6-12 
NODUPLICATES clause 6-12 
ON column clause 4-10, 6-9 
ON expr clause 6-10 
ON REPORT clause 4-15, 6-11 
ON ROW clause 4-11, 6-11 
printing "grand" and "sub" summaries 4-15 
printing summary lines at ends of reports 4-15 
removing definition 6-16 
SKIP clause 4-11, 6-11 
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SKIP PAGE clause 4-10 to 4-11, 6-11 
specifying multiple break columns 4-11, 6-9 
storing current date in variable for titles 4-25 
suppressing duplicate values 4-10, 6-12 
used in conjunction with COMPUTE 4-13, 
6-9, 6-11, 6-26 
Break definition 
listing current 4-12, 6-12 
removing current 4-12, 6-16 
BREAKS clause 4-12, 6-16 
BTITLE clause 6-63 
BTITLE command 4-18, 6-13 
old form F2 
printing blank lines before bottom title 4-20 
referencing column value variable 6-22 
See also TTITLE command 
Buffer 2-8 
appending text to a line in 3-5, 6-8 
deleting a line from 3-6, 6-36 
deleting all lines 3-2, 6-16 
executing contents 2-8, 6-6, 6-50 
inserting new line in 3-5, 6-43 
listing a range of lines 3-2, 6-45 
listing a single line 3-2, 6-45 
listing all lines 3-2, 6-45 
listing contents 3-3, 6-45 
listing the current line 3-2, 6-45 
listing the last line 3-2, 6-45 
loading contents into host system editor 3-6, 
6-39 
saving contents 3-7, 6-52 
BUFFER clause 3-2, 3-8, 6-16 
BUFFER variable F-3 


cC 


[Cancel] function 2-12 
[Cancel] key 2-2 
CENTER clause 4-18, 4-20, 6-72 
CHANGE command 3-2 to 3-3, 6-14 
CHAR clause 6-7 
CHAR columns 
changing format 4-5, 6-19 
default format 4-5, 6-19 
CLEAR clause 4-7, 6-18 


CLEAR command 6-16 
BREAKS clause 4-12, 6-16 
BUFFER clause 3-2, 3-8, 6-16 
COLUMNS clause 4-7, 6-16 
COMPUTES clause 4-17, 6-16 
SCREEN clause 3-26, 6-16 
SQL clause 6-16 
TIMING clause 6-16 
CLOSE Cursor command 
See your Oracle SQL language documentation 
CMDSEP variable 6-54 
COL clause 4-18, 4-20, 6-72 
COLOR clause 6-18 
COLUMN command 4-2, 6-17 
ALIAS clause 6-18 
and BREAK command 6-11 
and DEFINE command 6-34 
CLEAR clause 4-7, 6-18 
COLOR clause 6-18 
DEFAULT clause F-2 
displaying column values in bottom titles 
4-24, 6-22 
displaying column values in top titles 4-23, 
6-21 
entering multiple 6-23 
FOLD_AFTER clause 6-18 
FOLD_BEFORE clause 6-18 
FORMAT clause 4-4 to 4-5, 6-19 
formatting CHAR, LONG, and DATE 
columns 4-5, 6-19 
formatting NUMBER columns 4-4, 6-19 
HEADING clause 4-2, 6-21 
HEADSEP character 6-21 
JUSTIFY clause 6-21 
LIKE clause 4-6, 6-21 
LINEAPP clause 6-21 
listing a column's display attributes 4-7, 6-17 
listing all columns’ display attributes 4-7, 6-17 
NEW_VALUE clause 4-23, 4-25, 6-21 
NEWLINE clause 6-21 
NOPRINT clause 4-23, 6-22 
NULL clause 6-22 
OFF clause 4-7, 6-22 
OLD_VALUE clause 4-24, 6-22 
ON clause 4-7, 6-22 
PATTERN clause 6-22 


PRINT clause 6-22 

resetting a column to default display 4-7, 6-18 
restoring column display attributes 4-7, 6-22 
storing current date in variable for titles 4-25, 
6-24 

suppressing column display attributes 4-7, 
6-22 

TRUNCATED clause 4-6, 6-22 
WORD_WRAPPED clause 4-6, 4-8, 6-22 
WRAPPED clause 4-6, 6-22 


Column headings 


aligning 6-21 
changing 4-2, 6-21 
changing character used to underline 4-3, 6-60 
changing to two or more words 4-2, 6-21 
displaying on more than one line 4-2, 6-21 
suppressing printing in a report 6-56 
when truncated for CHAR and LONG 
columns 4-5, 6-19 
when truncated for DATE columns 4-5, 6-19 
when truncated for NUMBER columns 4-5, 
6-20 

Columns 
assigning aliases 6-18 
computing summary lines 4-13, 6-25 
copying display attributes 4-6, 6-21 
copying values between tables 5-4, 5-8, 6-31 
displaying values in bottom titles 4-24, 6-22 
displaying values in top titles 4-23, 6-21 
formatting CHAR, LONG, and DATE 4-5, 
6-19 
formatting in reports 4-2, 6-17 
formatting NUMBER 4-4, 6-19 
listing display attributes for all 4-7, 6-17 
listing display attributes for one 4-7, 6-17 
names in destination table when copying 5-4, 
6-31 
printing line after values that overflow 4-8, 
resetting a column to default display 4-7, 6-18 
resetting all columns to default display 4-7, 
6-16 
restoring display attributes 4-7, 6-22 
setting number of spaces between 6-58 
setting printing to off or on 4-23, 6-22 
specifying values to be computed 6-25 
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starting new lines 6-21 
storing values in variables 4-23, 6-21 
suppressing display attributes 4-7, 6-22 
truncating display for all when value 
overflows 4-6, 6-60 
truncating display for one when value 
overflows 4-6, 6-22 
wrapping display for all when value 
overflows 4-6, 6-60 
wrapping display for one when value 
overflows 4-6, 6-22 
wrapping whole words for one 4-8, 6-22 
COLUMNS clause 4-7, 6-16 
Comma, number format 4-4, 6-20 
Command files 3-7 
aborting and exiting with a return code 3-14, 
6-75 
allowing end-user input 3-16 
creating with a system editor 3-9 
creating with INPUT and SAVE 3-8 
creating with SAVE 3-7, 6-52 
editing with GET and SAVE 3-13 
editing with host system editor 3-13, 6-39 
in @ ("at" sign) command 3-12, 6-5 
in EDIT command 3-13, 6-39 
in GET command 3-11, 6-41 
in SAVE command 3-7 to 3-8, 6-52 
in SOLPLUS command 3-12, 6-65 
in START command 3-11, 6-68 
including comments in 3-10, 6-49 
including more than one PL/SQL block 3-9 
including more than one SQL command 3-9 
listing names with HOST command 3-8 
nesting 3-13 
passing parameters to 3-22, 6-68 
retrieving 3-11, 6-41 
running 3-11, 6-5, 6-68 
running a series in sequence 3-13 
running as you start SQL*Plus 3-12, 6-65 
running in batch mode 3-14, 6-40 
saving contents of buffer in 3-7, 6-52 
Command prompt 
host operating system 2-3 
SQL*Plus 2-4 
Command summary, SQL*Plus 6-2 
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Commands 1-2 


case 2-5 

collecting timing statistics on 2-12, 6-70 

disabling E-3 

host operating system, running from 

SQL*Plus 2-13, 6-42 

listing current in buffer 6-45 

re-enabling E-3 

spaces 2-5 

SQL*Plus, abbreviations 2-9 

SQL*Plus, command summary 6-2 

SOL*Plus, continuing on additional lines 2-10 
SOL*Plus, editing at command prompt 3-2 
SQL*Plus, ending 2-10 

SQL*Plus, entering and executing 2-9 

SQL*Plus, entering during SQL command 

entry 6-59 

SQL, continuing on additional lines 2-7 

SQL, editing with host system editor 3-6 

SQL, editing in buffer 3-2 

SQL, editing with host system editor 6-39 

SQL, ending 2-7 

SQL, entering and executing 2-6 

SQL, entering without executing 2-8 

SQL, executing current 2-8, 6-6, 6-50 

SQL, following syntax 2-7 

SQL, list of major D-1 

SQL, listing current in buffer 3-3 

SQL, saving current 3-7, 6-52 

SOL, setting character used to end and run 

6-59 i 
stopping while running 2-12 i 
storing in command files 3-7 j 
syntax conventions 1-4 i 
tabs 2-5 l 
typesof 2-5 ! 
variables that affect running 2-11 

writing interactive 3-16 


COMMENT command 


See your Oracle SQL language documentation 


Comments 


including in command files 3-10, 6-49 
using -- to create 3-10 

using /*..."/ to create 3-10 

using REMARK to create 3-10, 6-49 


COMMIT command 2-11 
COMPATIBILITY variable 6-55 
storing/not storing in SQL buffer 6-55 
See also your Oracle SQL language 
documentation 

COMPATIBILITY variable 6-55 


database specification 5-3 

disabling E-4 

username/password 5-2 to 5-3, 6-29 
CONTINUE clause 6-75 
Conventions, command syntax 1-4 
COPY command 5-4, 6-31 


in LOGIN file 3-15 


COMPUTE command 4-9, 6-25 


AVG function 4-13, 6-25 

computing a summary on different columns 
4-16 

COUNT function 4-13, 6-25 

listing all definitions 4-17, 6-26 

MAXIMUM function 4-13, 6-25 

MINIMUM function 4-13, 6-25 

NUMBER function 4-13, 6-25 

OF clause 4-13, 6-25 

ON column clause 4-13, 6-26 

ON expr clause 6-26 

ON REPORT clause 4-15, 6-26 

ON ROW clause 6-26 

printing "grand" and "sub" summaries 4-15 
printing multiple summaries on same column 
4-16 

printing summary lines at ends of reports 4-15 
printing summary lines on a break 4-13, 6-25 
referencing a SELECT expression in OF 6-25 
referencing a SELECT expression in ON 6-26 
removing definitions 4-17, 6-16 

STD function 4-13, 6-25 

SUM function 4-13, 6-25 

treatment of null values 4-13 

VARIANCE function 4-13, 6-25 


and @ (‘at" sign) 5-4, 6-31 

and ARRAYSIZE variable 5-7, 6-32 

and COPYCOMMIT variable 5-7, 6-32 
and LONG variable 5-7, 6-32 

APPEND clause 5-6, 6-32 

copying data between databases 5-4 
copying data between tables on one database 
5-8 

CREATE clause 5-5, 6-32 

creating a table 5-5, 6-32 

database link name 5-4, 6-31 

database specification 5-4, 5-6, 5-8 
destination table 5-4, 6-31 

determining actions 5-4 

determining source rows and columns 5-5, 
6-32 

error messages A-1 

FROM clause 5-4, 6-32 

INSERT clause 5-5, 6-32 

inserting data ina table 5-5 to 5-6, 6-32 
interpreting messages 5-7 

naming the source table with SELECT 5-5, 
6-32 

query 5-5, 6-32 

referring to another user’s table 5-7 
REPLACE clause 5-5, 6-32 

replacing data ina table 5-5, 6-32 


COMPUTES clause 4-17, 6-16 sample command 5-4 to 5-5 
CONCAT variable 3-22, 6-55 specifying column names for destination 5-4, 
CONNECT BY command 6-31 
See your Oracle SQL language documentation specifying the data to copy 5-5, 6-32 
CONNECT command (SQL) TO clause 5-4, 6-32 
disabling E-4 username/password 5-4, 5-6, 5-8, 6-31 to 6-32 
See also your Oracle SQL language USING clause 5-5, 6-32 


documentation when a commit is performed 6-32 
CONNECT command (SQL*Plus) 5-2 to 5-3, COPYCOMMIT variable 6-55 
6-29 relationship to COPY command 5-7, 6-32 


and @ ("at" sign) 5-3, 6-29 COUNT function 4-13, 6-25 
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CREATE clause 

in COPY command _ 5-5, 6-32 

in SAVE command 6-52 
CREATE command 

disabling E-4 

See also your Oracle SQL language 

documentation 
CRT files, changing default 6-55 
CRT variable 6-55 

in LOGIN file 3-15 


D 


Database changes, saving automatically 2-11, 
6-54 
Database link names 
in COPY command 5-4, 6-31 
in DESCRIBE command 6-37 
Database specifications 
in CONNECT command 5-3 
in COPY command 5-4, 5-6, 5-8 
in SOLPLUS command 5-3, 6-66 
Database, Administrator 1-6 
Databases 
connecting to default 5-2, 6-29 
connecting to remote 5-2, 6-29 
copying data between 5-4, 6-31 
copying data between tables on a single 5-8 
disconnecting without leaving SQL*Plus 5-2, 
6-38 
DATE columns 
changing format 4-5, 6-19 
default format 4-5, 6-19 
DATE, number format 6-20 
Date, storing current in variable for titles 4-25, 
6-21 to 6-22, 6-24 
DECLARE command (PL/SQL) 2-8 
See also your PL/SQL User's Guide and Reference 
DECLARE command (SQL) 
See your Oracle SQL language documentation 
DEFAULT clause F-2 
DEFINE command 3-16, 6-34 
and host system editor 3-6, 6-34 
CHAR values 6-34 
substitution variables 6-34 
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DEFINE variable 3-21, 6-56 
DEL command 3-2, 3-6, 6-36 
DELETE command 
disabling E-4 
See also your Oracle SQL language 
documentation 
3DEMOBLD 1-7 
and LOGIN file 3-14 
DEMODROP 1-8 
DESCRIBE command (SQL) 
See your Oracle SQL language documentation 
DESCRIBE command (SQL*Pius) 2-13, 6-37 
database link name 6-37 
table properties listed by 6-37 
DISABLED keyword, disabling commands 
E-3 
DISCONNECT command 5-2, 6-38 
DOCUMENT command F-2 
REMARK as newer version of F-2 
DOCUMENT variable F-3 
DROP command 
disabling E-4 
See also your Oracle SQL language 
documentation 
DUPLICATES clause 6-12 


E 


Easy*SQL 1-3 
ECHO variable 3-12, 6-56 
EDIT command 3-6, 6-39 
creating command files with 3-9 
defining EDITOR 3-6, 6-39 
disabling E-4 
modifying command files 3-13, 6-39 
EEEE, number format 6-20 
EMBEDDED variable 6-56 
Empty line, displaying 6-47 
Enhancement list, Version 3.0 B-1 
Error messages, interpreting 2-14 
Errors, making line containing current 3-3 
Escape characters, definition of 6-56 
ESCAPE variable 3-21, 6-56 


EXECUTE command 
See your Oracle SQL language documentation 
EXIT clause 6-75 
EXIT command 2-4, 6-40 
disabling E-4 
FAILURE clause 6-40 
SUCCESS clause 6-40 
WARNING clause 6-40 
Exit, conditional 6-75 
EXPLAIN command 
See your Oracle SQL language documentation 


F 


FAILURE clause 6-40 
FEEDBACK variable 6-56 
FETCH command 

See your Oracle SQL language documentation 
File names 

in @ ("at" sign) command 6-5 

in EDIT command 6-39 

in GET command 6-41 

in SAVE command 3-7, 6-52 

in SPOOL command 4-28, 6-64 

in SQLPLUS command 6-65 

in START command 6-68 
Files 

changing default CRT 6-55 

See also Command files 
FLUSH variable 6-56 
FOLD_AFTER clause 6-18 
FOLD_BEFORE clause 6-18 
FOR clause 

See your Oracle SQL language documentation 
FORMAT clause 

in COLUMN command 4-4 to 4-5, 6-19 

in TTITLE and BTITLE commands 4-22, 6-72 
Format models, number 4-4, 6-19 to 6-20 
Formfeed, to begin a new page 4-26, 6-57 
Forms, running from SQL*Plus 2-13, 6-51 
FROM clause (SQL) 

See your Oracle SQL language documentation 
FROM clause (SQL*Plus) 5-4, 6-32 


GET command 3-11, 6-41 
disabling E-4 
LIST clause 6-41 
modifying command files 3-13 
NOLIST clause 6-41 
retrieving command files 3-11, 6-41 
GRANT command E-1 
disabling E-4 
See also your Oracle SQL language 
documentation 
GROUP BY clause 
See your Oracle SQL language documentation 


H 


HAVING clause 
See your Oracle SQL language documentation 
HEADING clause 4-2, 6-21 
HEADING variable 6-56 
Headings 
See Column headings 
HEADSEP variable 6-57 
use in COLUMN command 4-2, 6-21 
HIDE clause 6-7 
HOST command 2-13, 6-42 
disabling E-4 
listing command file names with 3-8 
Host operating system 
command prompt 2-3 
editor 3-6, 6-39 
file, loading into buffer 6-41 
running commands from SQL*Plus 2-13, 6-42 


I 


Input 

accepting [Return] 3-26, 6-47 

accepting values from the user 3-24, 6-7 
INPUT command 3-2, 3-5, 6-43 

entering several lines 6-43 

using with SAVE to create command files 3-8 
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INSERT clause 5-5, 6-32 

INSERT command 
disabling E-4 
See also your Oracle SQL language 
documentation 

[Interrupt] key 2-2 


J 


JUSTIFY clause 6-21 


K 


Keyboard, significance of keys on 2-2 
Keys 

[Backspace] key 2-2 

[Cancel] key 2-2 

[Interrupt] key 2-2 

[Pause] key 2-2 

[Resume] key 2-2 

[Return] key 2-2 


L 


LEFT clause 4-18, 4-20, 6-72 

LIKE clause 4-6, 6-21 

Limits, SQL*Plus C-1 

Line numbers, for SQL commands 2-6 

LINEAPP clause 6-21 

Lines 
adding at beginning of buffer 6-43 
adding at end of buffer 6-43 
adding new after current 3-5, 6-43 
appending text to 3-5, 6-8 
changing width 4-26, 6-57 
deleting from buffer 3-6, 6-36 
determining which is current 3-3 
editing current 3-3 
listing all in buffer 3-2, 6-45 
removing blanks at end 6-60 

LINESIZE variable 4-19, 4-26, 6-57 

LIST clause 6-41 
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LIST command. 3-2, 6-45 
determining current line 3-3, 6-45 
making last line current 3-3, 6-45 
using an asterisk 3-2, 6-45 
LNO clause 6-63 
LOCK TABLE command 
disabling E-4 
See also your Oracle SQL language 
documentation 
Logging off 
conditionally 6-75 
ORACLE 5-2, 6-38 
SQL*Plus 2-4, 6-40 
Logging on 
ORACLE 5-2 to 5-3, 6-29 
SQL*Plus 2-3, 6-65 
LOGIN file 3-14, 6-66 
keeping the current one 3-15 
sample commands to include 3-15 
storing current date in variable for titles 4-25 
LONG columns 
changing format 4-5, 6-19 
default format 4-5, 6-19 
setting maximum width 6-57 
LONG variable 4-5, 6-57 
effect on COPY command 5-7, 6-32 
effect on LONG column format 6-19 


M 


MAXDATA variable 6-57 
MAXIMUM function 4-13, 6-25 
Message, sending to screen 3-24, 6-48 
MI, number format 6-20 


` MINIMUM function 4-13, 6-25 


N 


NEW_VALUE clause 4-23, 6-21 
storing current date in variable for titles 4-25, 
6-21, 6-24 

NEWLINE clause 6-21 

NEWPAGE command F-3 

NEWPAGE variable 4-26, 6-57 


NOAUDIT command 

disabling E-4 

See also your Oracle SQL language 

documentation 
NODUPLICATES clause 6-12 
NOLIST clause 6-41 
/NOLOG option 6-66. 
NOPRINT clause 4-23, 6-22 
NOPROMPT clause 6-7 
NULL clause 6-22 
Null values 

and COMPUTE command 4-13 

setting text displayed 6-22 
NULL variable 6-57 
NUMBER clause 3-26, 6-7 
NUMBER columns 

changing format 4-4, 6-19 

default format 4-4, 6-19 
Number formats 

$ 4-4, 6-20 

0 4-4, 6-20 

9 4-4, 6-20 

B 6-20 

comma 4-4, 6-20 

DATE 6-20 

EEEE 6-20 

MI 6-20 

period 6-20 

PR 6-20 

setting default 6-57 

V 6-20 
NUMBER function 4-13, 6-25 
NUMFORMAT variable 6-57 

in LOGIN file 3-15 
NUMWIDTH variable 6-57 

effect on NUMBER column format 4-4, 6-19 


O 


OF clause 4-13, 6-25 
OFF clause 

in COLUMN command 4-7, 6-22 

in SPOOL command 4-28, 6-64 

in TTITLE and BTITLE commands 4-23, 6-71 
OLD_VALUE clause 4-24, 6-22 

storing current date in variable for titles 6-22 


ON clause 
in COLUMN command 4-7, 6-22 
in TTITLE and BTITLE commands 4-23, 6-72 
ON column clause 
in BREAK command 4-10, 6-9 
in COMPUTE command 4-13, 6-26 
ON expr clause 
in BREAK command 6-10 
in COMPUTE command 6-26 
ON REPORT clause 
in BREAK command 4-15, 6-11 
in COMPUTE command 4-15, 6-26 
ON ROW clause 
in BREAK command 4-11, 6-11 
in COMPUTE command 6-26 
OPEN Cursor command 
See your Oracle SQL language documentation 
ORACLE for 1-2-3 1-3 
ORDER BY clause 
displaying column values in titles 4-23 
displaying values together in output 4-9 
See also your Oracle SQL language 
documentation. 
OUT clause 4-28, 6-64 
Output 
formatting white space in 6-59 
pausing during display 2-14, 6-58 
See also Query results 


P 


Page number, including in titles 4-21, 6-71 
Pages 
changing length 4-26, 6-57 
default dimensions 4-25 
matching dimensions to screen or paper size 
4-25 
setting dimensions 4-25 
PAGESIZE variable 2-6, 4-26, 6-57 
in LOGIN file 3-15 
Parameters 3-22, 6-68 
Password 1-7 
in CONNECT command 5-2 to 5-3, 6-29 
in COPY command 5-4, 5-6, 5-8, 6-31 
in SQLPLUS command 2-3, 5-3, 6-65 
PATTERN clause 6-22 
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PAUSE command 3-26, 6-47 
in LOGIN file 3-15 
[Pause] function 2-14 
[Pause] key 2-2 
PAUSE variable 2-14, 6-58 
Performance, over dial-up lines 6-60 
Period (.) 
number format 6-20 
terminating PL/SQL blocks 2-8 
PL/SQL 1-2, 2-8 
See also Blocks, PL/SQL 
PNO clause 6-63 
PR, number format 6-20 
PREPARE command 


See your Oracle SQL language documentation 


PRINT clause 6-22 
Printing 
See SPOOL command 
Privileges, restricting E-1 
PRODUCT_USER_PROFILE table E-1 
PROMPT clause 3-24, 6-7 
PROMPT command 3-24, 6-48 
customizing prompts for value 3-25 
Prompts for value 
bypassing with parameters 3-22 
customizing 3-25 
through ACCEPT 3-24 
through substitution variables 3-17 


Q 


Queries 1-2 
displaying number of records retrieved 2-6, 
6-56 
in COPY command 5-5, 6-32 
Query results 1-2 
displaying on-screen 2-6 
sending to a printer 4-28, 6-64 
storing ina file 4-28, 6-64 
QUIT command 6-40 
disabling E-4 
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R 


Record separators, printing 4-8, 6-58 
RECSEP variable 4-8, 6-58 
RECSEPCHAR variable 4-8, 6-58 
RELEASE clause 6-63 
REMARK command 3-10, 6-49 
RENAME command 
disabling E-4 
See also your Oracle SQL language 
documentation 
REPLACE clause 
in COPY command 5-5, 6-32 
in SAVE command. 3-14, 6-52 
Report breaks 
See BREAK command 
Report columns 
See Columns 
Report titles 
See Titles 
Reports 1-2 
clarifying with spacing and summary lines 
4-9 
creating bottom titles 4-18, 6-13 
creating master/detail 4-23, 6-21 to 6-22 
creating top titles 4-18, 6-71 
formatting column headings 4-2, 6-17 
formatting columns 4-4 to 4-5, 6-17 
starting on a new page 6-56 
[Resume] key 2-2 
Return code, specifying 3-14, 6-40, 6-75 
[Return] key 2-2 
REVOKE command E-1 
disabling E-4 
See also your Oracle SQL language 
documentation 
RIGHT clause 4-18, 4-20, 6-72 
ROLLBACK command 
COMPATIBILITY variable 6-55 
storing/not storing in SQL buffer 6-55 
See also your Oracle SQL language 
documentation 


Rows 
performing computations on 4-13, 6-25 
setting maximum width SQL"Plus can 
process 6-57 
setting number retrieved at one time 6-54 
setting the number after which COPY 
commits 6-55 
RUN command 2-8, 6-50 
disabling E-4 
executing current PL/SQL block 2-8 
executing current SQL command 2-8 
making last line current 3-3 
similar to / (slash) command 2-8, 6-50 
RUNFORM command 2-13, 6-51 


S 


Sample tables 1-5 
access to 1-7 
DEMOBLD 1-7 
DEMODROP 1-8 

SAVE command 3-7, 6-52 
APPEND clause 3-14, 6-52 
CREATE clause 6-52 
disabling E-4 
modifying command files 3-13 
REPLACE clause 3-14, 6-52 


storing commands in command files 3-7, 6-52 


using with INPUT to create command files 
3-8 
SAVEPOINT command 


See your Oracle SQL language documentation 


SCAN variable 3-21, 6-58 
SCREEN clause 3-26, 6-16 
Screen, clearing 3-26, 6-16 
Securit 
See PRODUCT_USER_PROFILE table 
SELECT command 
and BREAK command 4-9, 6-10 to 6-11 
and COLUMN command 6-18 
and COMPUTE command 4-9, 6-25 
and COPY command 5-5, 6-32 
and DEFINE command 6-34 
and ORDER BY clause 4-9 


disabling E-4 

storing current date in variable for titles 4-25 
See also your Oracle SQL language 
documentation 


Semicolon (;) 


in PL/SQL blocks 2-8 
in SQL commands 2-6 to 2-7 
in SQL*Plus commands 2-10 
not needed when inputting a command file 
3-9 
not stored in buffer 3-3 

SET command 2-11, 6-53 
ARRAYSIZE variable 5-7, 6-54 
AUTOCOMMIT variable 2-11, 6-54 
BLOCKTERMINATOR variable 6-54 
BUFFER variable F-3 
CMDSEP variable 6-54 
COMPATIBILITY variable 3-15, 6-55 
CONCAT variable 3-22, 6-55 
COPYCOMMIT variable 5-7, 6-55 
CRT variable 3-15, 6-55 
DEFINE variable 3-21, 6-56 
DOCUMENT variable F-3 
ECHO variable 3-12, 6-56 
EMBEDDED variable 6-56 
ESCAPE variable 3-21, 6-56 
FEEDBACK variable 6-56 
FLUSH variable 6-56 
HEADING variable 6-56 
HEADSEP variable 4-2, 6-57 
LINESIZE variable 4-19, 4-26, 6-57 
LONG variable 4-5, 5-7, 6-19, 6-57 
MAXDATA variable 6-57 
NEWPAGE variable 4-26, 6-57 
NULL variable 6-57 
NUMFORMAT variable 3-15, 6-57 
NUMWIDTH variable 4-4, 6-19, 6-57 
PAGESIZE variable 2-6, 3-15, 4-26, 6-57 
PAUSE variable 2-14, 3-15, 6-58 
RECSEP variable 4-8, 6-58 
RECSEPCHAR variable 4-8, 6-58 
SCAN variable 3-21, 6-58 
SPACE variable 6-58 
SQLCASE variable 6-59 
SQLCONTINUE variable 6-59 
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SQLNUMEBER variable 6-59 
SQLPREFIX variable 6-59 
SQLPROMPT variable 6-59 
SQLTERMINATOR variable 6-59 
SUFFIX variable 6-59 
TAB variable 6-59 
TERMOUT variable 4-25, 6-60 
TIME variable 3-15, 6-60 
TIMING variable 6-60 
TRIMOUT variable 6-60 
TRUNCATE variable F-4 
UNDERLINE variable 4-3, 6-60 
VERIFY variable 3-18, 3-22, 6-60 
WRAP variable 4-6, 6-60 
SET command variables 
See System variables 
SET TRANSACTION command 
See your Oracle SQL language documentation 
SHOW clause 6-70 
SHOW command 2-11, 6-63 
ALL clause 6-63 
BTITLE clause 6-63 
listing current page dimensions 4-27 
LNO clause 6-63 
PNO clause 6-63 
RELEASE clause 6-63 
SPOOL clause 6-63 
SQLCODE clause 6-63 
TTITLE clause 6-63 
USER clause 6-63 
SHOWMODE variable 6-58 
-SILENT clause 6-66 
Site Profile 6-66 
SKIP clause 
in BREAK command 4-10 to 4-11, 6-11 


in TTITLE and BTITLE commands 4-18, 4-20, 


6-72 
used to place blank lines before bottom title 
4-20 
SKIP PAGE clause 4-10, 4-11, 6-11 
Slash (/) command 
See / (slash) command 
SPACE variable 6-58 
SPOOL clause 6-63 
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SPOOL command 4-28, 6-64 
disabling E-4 
filename 4-28, 6-64 
OFF clause 4-28, 6-64 
OUT clause 4-28, 6-64 
turning spooling off 4-28, 6-64 
SQL buffer 
See Buffer 
SQL clause 6-16 
SQL commands, list of major D-1 
SQL database language 1-2 
SQL*Forms 1-3 
invoking from SQL*Plus 2-13, 6-51 
SQL*Graph 1-3 
SQL*Net protocol 5-3 
SQL*Plus 
basic concepts 1-2 
command prompt 2-4 
command summary 6-2 
exiting 2-4, 6-40 
exiting conditionally 6-75 
limits C-1 
LOGIN file 3-14 
overview 1-2 
running commands in batch mode 3-14, 6-40 
setting up environment 3-14 
shortcuts to starting 2-4 
starting 2-3, 6-65 
what you need to run 1-6 
who can use 1-3 
SQL*QMX 1-3 
SQL*ReportWriter 1-3 
SQL.LNO, referencing in report titles 6-71 
SQL.PNO, referencing in report titles 4-21, 
6-71 | 
SQL.RELEASE, referencing in report titles 
6-71 
SQL.SQLCODE, referencing in report titles 
6-71 
SQL.USER, referencing in report titles 6-71 
SQLCASE variable 6-59 
SQLCODE clause 6-63 
SQLCONTINUE variable 6-59 
SQLNUMBER variable 6-59 





SQLPLUS command 2-3, 6-65 
-? clause 6-66 
-SILENT clause 6-66 
/NOLOG clause 6-66 
and @ (‘at" sign) 3-12, 5-3, 6-65 
connecting to a remote database 5-3 
database specification 5-3, 6-66 
running command files 3-12 
username/password 2-3, 6-65 
SQLPREFIX variable 6-59 
SQLPROMPT variable 6-59 
SQLTERMINATOR variable 6-59 
START clause 6-70 
START command 3-11, 6-68 
arguments 3-22, 6-68 
command file 3-11, 6-68 
disabling E-4 
passing parameters to a command file 3-22, 
6-68 
similar to @ (“at" sign) command 3-12, 6-5, 
6-69 
Starting SQL*Plus 2-3, 6-65 
shortcuts 2-4 
STD function 4-13, 6-25 
STOP clause 6-70 
Substitution variables 3-17 
appending characters immediately after 3-19 
avoiding unnecessary prompts for value 3-19 
concatenation character 6-55 
DEFINE command 6-34 
prefixing 6-56 
restrictions 3-21 
single and double ampersands 3-19 
suppression of 6-58 
system variables used with 3-21 
undefined 3-17 
where and how to use 3-17 
SUCCESS clause 6-40 
SUFFIX variable 6-59 
used with @ ("at" sign) command 6-5 
used with EDIT command 6-39 
used with GET command 6-41 
used with SAVE command 6-52 
used with START command 6-68 
SUM function 4-13, 6-25 


Summary lines 
computing and printing 4-13, 6-25 
computing and printing at ends of reports 
4-15 
computing same type on different columns 
4-16 
printing "grand" and "sub" summaries 4-15 
printing multiple on same break column 4-16 
Syntax 
conventions 1-4 
COPY command 5-4 
Syntax rules 
SQL commands 2-7 
SQL*Plus commands 2-10 
SYSDATE 4-25 
System variables 2-11, 6-61 
changing current settings 6-53 
listing current settings 2-11, 6-63 
listing old and new values 6-58 
used with substitution variables 3-21 
System-maintained values 
displaying in titles 4-21, 6-71 
formatting in titles 4-22 


T 


TAB clause 6-72 

TAB variable 6-59 

Tables 1-2 
access to sample 1-7 
controlling destination when copying 5-5, 
6-32 
copying values between 5-4, 5-8, 6-31 
DEPT 1-5 
EMP 1-5 
listing column definitions 2-13, 6-37 
referring to another user’s when copying 5-7 
sample 1-5 

TERMOUT variable 6-60 
storing current date in variable for titles 4-25 
using with SPOOL command 6-64 

Text 
adding to current line with APPEND 3-5, 6-8 
changing old to new with CHANGE 3-3, 6-14 
clearing from buffer 3-2, 6-16 
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Text editor, host operating system 3-6, 6-39 
TIME variable 6-60 
in LOGIN file 3-15 
TIMING clause 6-16 
TIMING command 2-12, 6-70 
deleting all areas created by 6-16 
deleting current area 6-70 
SHOW clause 6-70 
START clause 6-70 
STOP clause 6-70 
TIMING variable 6-60 
Titles 
aligning elements 4-19, 6-72 
displaying at bottom of page 4-18, 6-13 
displaying at top of page 4-18, 6-71 


displaying column values 4-23, 6-21 to 6-22 
displaying current date 4-25, 6-21 to 6-22, 6-24 


displaying page number 4-21, 6-71, 6-73 
displaying system-maintained values 4-21, 
6-71 

formatting elements 6-72 


formatting system-maintained values in 4-22 


indenting 4-20, 6-72 
listing current definition 4-23, 6-13, 6-71 
restoring definition 4-23, 6-72 
setting lines from top of page to top title 
4-26, 6-57 
setting lines from top title to end of page 
4-26, 6-57 
setting top and bottom 4-18, 6-13, 6-71 
spacing between last row and bottom title 
4-20 
suppressing definition 4-23, 6-71 

TO clause 5-4, 6-32 

TRIMOUT variable 6-60 

TRUNCATE variable F-4 

TRUNCATED clause 4-6, 6-22 

TTITLE clause 6-63 

TTITLE command 4-18, 6-71 
aligning title elements 4-19, 6-72 
BOLD clause 6-72 
CENTER clause 4-18, 4-20, 6-72 
COL clause 4-18, 4-20, 6-72 
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FORMAT clause 4-22, 6-72 

indenting titles 4-20, 6-72 

LEFT clause 4-18, 4-20, 6-72 

listing current definition 4-23, 6-71 

most often used clauses 4-18 

OFF clause 4-23, 6-71 

old form F-4 

ON clause 4-23, 6-72 

referencing column value variable 4-23, 6-21 
restoring current definition 4-23, 6-72 
RIGHT clause 4-18, 4-20, 6-72 

SKIP clause 4-18, 4-20, 6-72 

suppressing current definition 4-23, 6-71 
TAB clause 6-72 


U 


UNDEFINE command 3-16, 6-74 
and DEFINE command 6-34 
UNDERLINE variable 4-3, 6-60 
UPDATE command 
disabling E-4 
See also your Oracle SQL language 
documentation 
Upgrading applications from prior versions 
USER clause 6-63 
User Profile 3-14, 6-66 
User variables 3-16 
defining 3-16, 6-34 
deleting 3-16, 6-74 
displaying in titles 6-71 
in ACCEPT command 3-24, 6-7 
listing definition of one 3-16, 6-34 
listing definitions of all 3-16, 6-34 
Username 1-7 
connecting under different 5-2, 6-29 
in CONNECT command 5-2 to 5-3, 6-29 
in COPY command 5-4, 5-6, 5-8, 6-31 
in SQLPLUS command. 2-3, 5-3, 6-65 
USING clause 5-5, 6-32 


vV 


V, number format 6-20 
VALIDATE INDEX command 
disabling E-4 
See also your Oracle SQL language 
documentation 
Variables 
See Substitution variables 
See System variables 
See User variables 
VARIANCE function 4-13, 6-25 
VERIFY variable 3-18, 3-22, 6-60 


w 


WARNING clause 6-40 
WHENEVER command 
See your Oracle SQL language documentation 
WHENEVER SQLERROR command 3-14, 
6-75 
CONTINUE clause 6-75 
EXIT clause 6-75 
WHERE clause 
See your Oracle SQL language documentation 
WORD_WRAPPED clause 4-6, 4-8, 6-22 
WRAP variable 4-6, 6-60 
WRAPPED clause 4-6, 6-22 
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Reader’s Comment Form 


SQL*Plus User’s Guide and Reference 
Part No. 5142-V3.0 


Oracle Corporation welcomes your comments and suggestions on the quality and usefulness of this 
publication. Your input is an important part of the information used for revisions. 


e Did you find any errors? 

e Is the information clearly presented? 

« Do you need more information? If so, where? 

+ Are the examples correct? Do you need more examples? 
e What features did you like most about this manual? 


If you find any errors or have any other suggestions for improvement, please indicate the topic, 
chapter, and page number below: 























Please send your comments to: 


SQL*Plus Product Manager 
Oracle Corporation 

20 Davis Drive 

Belmont, California 94002 
(415) 598-8000 


If you would like a reply, please give your name, address, and telephone number below: 











Thank you for helping us improve our documentation. 


ORACLE” 5h2.V30 





